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随 看 SAP 在 中 国企 业 中 的 广泛 应 用 ，SAP 实施 及 运 维 行业 也 获得 了 局 速 增长 ，SAP 相关 
技术 也 得 到 了 广泛 的 应 用 ， 这 其 中 不 乏 SAP Web FRK nay de Á 

作者 参考 SAP 官方 资料 和 加 上 作者 多 年 积 昧 的 项 目 经 验 对 ABAP 开发 技术 做 了 整理 和 所 
Kk, El Web Dynpro For ABAP 这 样 一 门 SAP Web 编程 的 高 级 开发 技术 编写 了 本 书 。 

以 往 的 书籍 仅 对 ABAP Web 编程 做 一 下 概念 上 的 剖析 ， 能 够 提 及 原理 、 染 构 及 实现 的 图 
书 少 之 又 少 。 本 书 的 特点 在 于 对 各 技术 原理 、 实 施 前 提 、 实 施 步 又 、 实 施 结 末 作 了 详尽 的 说 
明 ， 更 有 关于 SAP WDA 开发 类 和 服务 类 的 相关 介绍 ， 以 帮助 那些 询 望 提升 技术 水 平 的 SAP 
JF A A. 

学 习 SAP Web 开发 技术 ， 开 发 者 不 仅 需 要 提高 目 身 的 水 平 “ 如 从 面 问 过 程 编 程 到 面 问 对 
象 编程 的 转弯， 从 面向 对 象 的 语言 开发 到 基于 MVC 理论 的 Web 开发 之 间 的 转变 及 对 MVC 
理论 下 的 数据 关系 映射 的 了 解 )， 还 需要 熟悉 SAP 相关 集成 应 用 ，( 如 Web Dynpro 组 件 中 如 
WRR Flex, RALE EP (Enterprise Portal), Adobe Form 电子 表格 等 )， 更 需要 SAP 开发 
者 对 各 种 蜗 级 概念 的 掌握 (如 如 何 创建 和 使 用 辅助 类 ， 如 何 创建 和 使 用 服务 调用 ， 与 用 户 交 
互 时 如 何 使 用 对 话 框 等 )。 

参与 本 书 编写 的 有 孙 东 文 〈 笔 名 : KRENN SESS. WRK sx. H Ta KE 44 E, 
书 中 难免 有 芷 漏 和 不 足 之 处 ， 请 读者 批评 指正 。 


编 者 


IH 


前 言 

第 1 章 
1.1 
1:2 
1.3 


第 2 章 
2.1 
22 
2.3 
2.4 
第 3 章 
第 4 章 
4.1 
4.2 
4.3 


44 


4.5 


4.6 


4.7 
第 5 = 
5.1 
5:2 


IV 


H x 


Web Dynpro For ABAP 的 由 来 1 
A A Dt A E Qs Ctr EE E E E ] 
EGG ] 
Web Dynpro mee nennen 2 
1.3.4. Web Dynpro 的 双重 目的 站 2 
1.3.2 Web Dynpro ZR 2 
集 成 Adobe Flash Íslands EIL 4 
Flash Island UI JCA IH E "E 4 
Flash Island UI 元 ES 的 事件 RT Te A HUN DETEE 5 
编辑 Adobe Flex 应 用 程序 HH 5 
四 9 
文件 操作 GRAB MR CURA TA dedu ati VEA LE LA AN VO GIF UA KU OOOO VE COM usate VO eb re LUIS VO IF RUE DESC UE UP TU COM UE 18 
门户 集 成 (Portal Integration ) ne de en EE 25 
绑 定 到 门户 的 准备 …… v: 25 
门户 中 Web Application 集成 25 
门 p 事件 (Portal EventS) ee 29 
4.3.1 y qa SE S: 29 
4.3.2 ”注册 并 处 理事 件 eeeeetteeeeerteeereerseeeeersseeeeersseeeeerseeeeensseeeeenseeeeennseeeeerssereeessseeeennseeeeessee 31 
事件 应 用 实例 TT T A E WET ET A ayauya aaa 32 
;"VAEEJIAAI D 20 
442 创建 iView 及 页 面 eeeeeeeeeeeeretetteerertteteeereseeeeerseeeeersseeeeerseeeeernseeeeersseeeeesseeeeessseeeeessee 40 
门户 导航 (Portal Navigation ) 人 49 
451 基于 对 象 的 导航 (OBN) cem enne nennen 49 
4.5.2 VOBIS —w——— 51 
4.5.3 CLUBS MM————— 53 
4.5.4 Resume Plugs 和 门户 导航 nne 54 
EE Een dvatesteto E E ERI UA Spb U SCR MAS Ep 54 

"ABESSE 54 

4.6.2. IPS c ———: 58 

4.6.3 应 用 程序 导航 测试 站 65 
工作 保护 模 X (Work Protect Mode) HMM 67 

f 成 表单 (Integrating Forms) ee 69 
集成 表单 条 件 eee mH HH eene eene 70 
在 Web Dynpro 应 用 中 集成 PDF 表单 SP E E E E A E A E A T 7] 


5.3 


5.4 
5.5 

5.6 

5.7 

5.8 

5.9 

第 6 章 
6.1 


6.2 


6.3 


6.4 


插入 互动 表单 a 7I 
5.3.1 在 Web Dynpro 应 用 中 使 用 Adobe Forms 72 
5.32. TE Web Dynpro 应 用 中 新 建 Adobe Forms eeeeeeteetetetteterererterererereerererereerererereerererereet 76 

插入 已 有 PDF 表单 (MIME NI 9) —————————Ó————— 84 
表单 集成 中 的 数字 签名 (Digital Signatures) mm 86 

支持 Adobe 库 中 的 UI 元 慰 a 86 

交互 式 表单 应 用 —————— ——————————————— — gg 

基于 ABAP 数据 字典 接 口 表单 和 88 

B3 Adobe Toolbar nn 89 
ALV 在 Web Dynpro ABAP 中 的 应 用 90 
在 应 用 程序 中 集成 ALV iesin iierserereseerstieti rosier testense reitin riiste treiter rester reeis 90 
6.1.1 组件 使 用 定义 ee 02 
6.1.2 ”供应 数据 eeereeeeereeeerrereesseeeerseeeerseeeerereessereesseeeerseeeeseeeeerereensereesseeeesseeeesereeesereessereesee 02 
6.1.3 使 用 ALV 视图 94 
6.1.4 ALV 配置 模型 对 象 94 
GREEN NAA UE 95 
6.1.6 类 图 (Class Diagram) ee 96 

管理 ALV 输出 领域 和 96 
6.2.1 ALV 标题 CALV Output Header) semen 96 
VPEMEJU EEE———(«———————————————— 908 
VAREEIERRE————— 99 
QEWEW FU L£L——(««««((—R 103 
6.2.5 页 眉 与 页 脚 区 域 ——— 105 
VQISRHLIGUISM—Á!€ 110 
ALV 输出 的 外 观 有 111 
6.3.1 将 属性 分 配给 列 和 单元 格 mene ene eene 111 
632 ALV 输出 、 列 和 单元 格 的 大 小 站 112 
6.3.3 NEIKIRHJA, IPE Aa 114 
6.3.4 ALV 输出 、 列 和 单元 格 的 颜色 eme eee eene eene 114 
6.3.5 文本 属性 —(«( m 115 
6.3.6 FYRDFZ EAR SE ————— —Á—— 116 
6.3.7 C DNESACIOL JR 116 
63.8 DUE | EU Hmmm eee enne 118 
6.3.9” 宗 输 出 的 蔡 换 文本 Hm 121 
了 预定 义 标准 ALV JJJBB «eee HH ia 121 
TAE a —— An 121 
"EB: 2————————— 5—^—^—^^—^— 2 124 
643 H (jjF) ————Ó 126 
64.4 配置 和 个 性 化 ALV 输出 站 129 


6.4.5 输出 VR NF Russ s d EAE NR UD VIENNE eau UR dau Oe NER MN QUE IMEEM MN MO SD EAM RS MANN d ME 130 


65 JIJBSB. AR H OWISEAIE e M HH eH HH 134 
65. 提供 ALV 功能 134 

6.52 ”没有 数据 变化 的 交互 与 处 理 141 

6.53 ”可 编辑 ALV HJ EZAN HERE 143 

AA WIES IEEE ——— € 147 

6.66 接口 控制 器 的 方法 和 事件 ee HRRmHHHHHHeemHHHHHeHeeHHHHHHHee 149 
6.6.1 DATA CHEC 隐 ee 149 

6.6.2 GET CONFIG DATA ee 149 

6.63 GET MODEL ee 151 

6.6.4 GET MODEL EXTENDED teens 151 

6.66.5 SET FOCUS ee 152 

6.6.6 SET DATA ee 152 

6.6.7 ON AFTER CONFIG ee 152 

6.6.8 ON CELL ACTION ee 152 

6.6.9 ON CLICK ee 153 
6.6.10 ON DATA CHECK 153 
6.6.11 ON FUNCTION eeeeeetetereretetterererererererererereressenerererererererererenennenenererenererererereret 153 
6.6.12 ON LEAD SELECT ee 153 
6.6.13 ON SELECT eeeeeeeeererererereerererererererererererererresererererenerenerereneneneserererererererereres 153 
6.6.14 ON STD FUNCTION AFTE ee 154 
6.6.15 ON STD FUNCTION BEFO «teens 154 

6.7 在 Web Dynpro 应 用 中 使 用 ALV Erg fer Pi SE p| eee HIM 154 
第 7 章 高 级 概念 oeeeeeeerrrrrerrrrrrrerrerrreereerererreerreereeereerretreseteteeeetetetesererereeeeeeereeteeereerreeenesees 164 
7.1 ”组 件 辅助 类 ee HH HH Henne 164 
72 Web Dynpro 应 用 中 的 服务 调用 (Service Call) MM 170 
72. 创建 一 个 Service Call: ee enne rennen nennen 171 
"PVEMELJSET Ie ——— 175 

7.3 TEHRDE WE e MH HMM emm eH 180 
734 |JijJ—ZHfEE S HDGEBEE mmm eee 181 

732 ”调用 使 用 组 件 的 对 话 柱 mmm eee 183 

733 调用 确认 对 话 杠 — 184 

74 输入 帮助 p ida IA M IAM LI DD PILAM CI DL NELLO LO DEOR UD OM LI DL D DU ELO LL DOLCE OL AE 189 
7.4.1 OVS 输入 帮助 站 193 
VELA PA TUE 195 

7.4.3 选择 标准 «2 196 

7.44.» ”编辑 Web Dynpro IRE eene 197 

7.5 ABAP Web Dynpro 应 用 程序 的 帮助 文本 nM HMM 214 
7.5.1 Explanation UI JGR 2 216 


VI 


7.5.2 Explanation 属性 de dais VR du siia da Ed e rau idt V ORE GRE CU Mo clue d a ER ee ee ie Rod a MU aM Rue ua CE 218 


7.5.3 HÆL Fl 帮助 eeeeeeeeeteeeeeseeeerseeeereeeeeseeeerseeeesseeeerseeeerereeesereenseeeesseeeesseeessereensereesseeees 220 

76 13H a Messages eene nnne 22] 

7.6.1 消息 弹出 eeeeeeerereeererereesseeeerseeeerseeeesereersereesseeeerseeeeneteesrereenseeeesseeeesseeeeseeeenseereesseeees 222 

7.6.2 TSS SS S RR 223 

7.6.3 K Q Oa 224 

7.64 ”重用 组 建 和 MessageArea 元 素 tenen 225 

7.6.5 ”编辑 Web Dynpro HIP eene 225 

UT Suspend 和 Resume 调用 和 234 

7.8 处 理 Web 图 标 MM M M M M MM MM HIR RRHeHHHRHRHIRIRHIHHeeeHey 237 
附录 A Web Dynpro For ABAP 系统 类 a 239 
附录 B 服务 类 (Service Classes) RH 259 


VII 


H1% Web Dynpro For ABAP 的 由 来 


Web Dynpro 是 传统 Dynpro 编程 方法 在 互联 网 时 代 的 扩展 。SAP 为 Web Dynpro 提供 了 两 
种 开发 语言 (ABAP 和 Java), TÆMWA I Web Dynpro for ABAP 和 Web Dynpro for Java. 

Web Dynpro 与 SAP 以 往 的 设计 范例 完全 不 同 ， 代 表 了 开发 基于 Web 的 ERP Application 
取得 的 重大 突破 。 基 于 MVC 设计 模式 的 SAP Web Dynpro for ABAP 在 开发 基于 表单 的 用 户 界 
rii p RUE ed TER X. 

Web Dynpro 采用 了 一 种 高 级 的 MVC / Data Binding 架构 模式 ， 并 且 提 供 了 非常 友好 的 编 
ERHO, Web 接口 可 以 使 用 拖 电 的 方式 进行 开发 。 由 于 Web Dynpro 运行 于 SAP NetWeaver 
平台 ， 访 平台 在 传统 Dynpro 开发 上 的 优势 也 被 使 用 得 淋漓 尽 致 。 使 用 Web Dynpro 可 以 非常 
迅速 地 开发 出 企业 级 的 Application 程序 ， 而 开 友 者 只 需要 关注 其 业务 流程 ， 关 于 版 本 管理 、 
质量 控制 、 发 布 、 性 能 等 内 容 将 由 NetWeaver 平台 帮助 完成 。 


1.1 ABAP 


ABAP 作为 一 种 面向 特定 应 用 的 第 四 代 编 程 语 言 最 早 在 20 世纪 80 年 代 被 开发 。 它 原本 
是 作为 一 种 报表 语言 应 用 在 SAP R/2 上 ， 这 是 一 个 帮助 大 型 公司 在 大 型 机 上 建立 原材料 管理 
和 财务 会 计 管 理 商务 应 用 的 平台 。ABAP 本 来 也 是 德语 Allgemeiner Berichts Aufbereitungs 
Prozessor 的 缩写 ， 意 思 是 通用 报表 预 处理 器 。ABAP 第 一 次 引入 了 “ 逮 辑 数据 库 ” 的 概念 ， 
它 在 基本 的 数据 库 层 提供 了 更 高 级 的 抽象 。 

虽然 SAP 1992 年 就 发 布 了 R/3， 但 ABAP 一 直 用 于 为 R/3 系统 编写 程序 。 在 20 世纪 00 
年 代 ， 随 着 计算 机 硬件 的 发 展 ， 越 来 越 多 的 SAP 的 应 用 软件 和 系统 都 用 ABAP 来 实现 。 直 到 
2001 年 ， 儿 乎 所 有 的 基本 功能 都 是 由 ABAP 编程 实现 的 。1999 4E, SAP 在 发 布 R/3 4.6 版 的 
同时 也 发 布 了 一 个 对 ABAP 的 面 问 对象 扩 展 ， 叫 作 ABAP Objects. 

SAP 最 新 的 开发 平台 NetWeaver 同时 支持 ABAP 和 Java. 

2007 年 ，SAP 的 应 用 服务 器 平台 已 经 转向 了 Web NetWeaver 的 SOA 平台 ，ABAP 也 随 
即 成 为 SAP 中 Web Dynpro 的 开发 语言 。 


12 NetWeaver 


NetWeaver 是 SAP 所 有 应 用 的 技术 集成 平台 的 名 字 。SAP 的 所 有 产品 (包括 ECC (ERP 
Core Component), CRM. SRM 和 上 所 有 的 解决 方案 (包括 mySAP ERP, mySAP Business Suite 
SR) 都 基于 这 一 平台 。 

SAP NetWeaver 是 一 种 可 随时 用 于 业务 运作 、 面 问 服 务 的 平 合 ， 适 用 于 SAP 的 所 有 人 解决 
方案 。SAP NetWeaver 平台 内 骸 了 商务 智能 (BI) /&J6 2E 5] 9 145] (Radio Frequency 
Identification, RFID) 功能 ， 能 够 有 效 地 进行 主 数据 管理 。 同 时 ， 不 同业 务 角色 的 用 户 可 以 通 

7 


过 企业 门户 《Enterprise Portal, EP) 上 网 访问 企业 内 的 各 种 信息 。SAP NetWeaver 是 近年 来 具 
有 革命 意义 的 基础 应 用 和 集成 平台 产品 ， 它 建立 了 面 癌 服务 的 新 的 SAP. 企业 服务 信息 系统 基 
础 架构 CEenterprise Service Architecture，ESA)， 提 供 了 一 种 完全 开放 而 且 有 灵活 的 基础 设施 ， 
使 各 公司 能 够 通过 现 有 的 IT 投资 获取 附加 值 ， 从 而 降低 了 企业 的 IT 总 成 本 。 它 既是 应 用 平 
£> 而 且 DB 具有 与 OS 无 关 性 , 通过 与 .NET 和 J2EE 的 互动 增加 了 灵活 性 ; 同时 又 实现 了 人 
员 集 成 〈 多 渠道 访问 、 企 业 门 户 、 协 作 )， 信 息 集 成 〈 商 业 智 能 、 知 识 管理 、 主 数据 管理 等 ) 
和 流程 集成 〈 集 成 代理 和 商业 流程 管理 等 )。 
Web Dynpro 就 是 基于 这 一 平台 ， 在 SAP 的 各 种 解决 方案 中 应 运 而 生 的 。 


1.3 Web Dynpro 


Dynpro 通俗 地 讲 殴 是 屏幕 主 界面 ， 其 窗口 一 般 包 括 标题 栏 、 有 荣 单 栏 、 工 具 栏 、 状 态 栏 和 
EJ. Dynpro 特 指 SAP GUI 主 界 面 区 域 的 内 容 ， 是 ABAP 程序 的 一 种 。 

Dynpro 是 由 用 户 界 面 元 素 和 其 背后 的 商业 则 辑 组 成 的 动态 程序 。Dynpro 的 主要 组 成 部 
2 HU T: 

1) JRE liU Déc 7 PT DEAS 8. 

2) 界面 元 素 的 位 置 ， 如 文本 标签 、 文 本 输入 框 、 按 钮 等 界面 元 素 的 位 置 安排 。 

3) 界面 元 素 的 属性 。 

4) 程序 馆 辑 。 这 些 程序 将 调用 后 人 台 的 ABAP 代码 模块 。 


13.1 Web Dynpro 的 双重 目的 


1) 尽 可 能 避免 对 UI 层 进行 编码 。 

2) 允许 业务 应 用 程序 独立 于 后 台 业 务 平台 ， 以 前 并 表现 层 的 形式 存在 。 

为 了 开发 用 户 界 面 ，Web Dynpro 提供 了 一 个 公开 的 元 模型 ,这样 束 直接 导 八 几乎 无 须 编 
写 程 序 代 码 。 

从 技术 角度 来 讲 ，SAP 适用 于 Java 和 ABAP 的 Web Dynpro 开发 问 基 于 Web 的 用 户 界面 
近 出 了 革命 性 的 一 步 。 它 完全 不 同 于 SAP 之 前 使 用 的 任何 设计 范例 , 这 标志 看 基于 Web 的 企 
业 资 源 规 划 (ERP〉 应 用 程序 的 开发 有 了 单 大 突破 。 

Web Dynpro 应 用 程序 是 使 用 基于 模型 视图 控制 器 (MVC) 范例 的 声明 式 编程 技术 构建 
的 。 也 束 是 说 ， 用 刀 可 以 指定 各 户 闪 包括 哪些 用 户 界 面 元 素 ， 以 及 这 些 元 系 将 从 哪里 获取 数 
据 。 还 可 以 通过 声明 的 方式 定义 应 用 程序 中 可 能 的 导航 路 人 径 ， 用 于 创建 用 户 界 面 的 所 有 代码 
将 在 标准 运行 框架 内 目 动 生成 。 这 可 以 减轻 用 户 在 编写 HTML 时 的 重复 编码 工作 量 ， 并 使 其 
能 够 与 JavaScript 进行 交互 。 

SAP NetWeaver 7.0 (SAP NetWeaver Application Server 7.0) 及 以 上 版 本 都 可 以 使 用 ABAP 
Web Dynpro。 为 了 开发 Web Dynpro 应 用 程序 的 实体 ， 对 和 象 导 航 占 (事务 代码 SE80) 已 有 上 所 
强化 。 

Web Dynpro 专门 用 于 文 持 结构 化 开发 。 其 软件 模块 化 单元 是 Web Dynpro HF, HASE 
起 来 构建 复杂 的 应 用 程序 。 


1.3.2 Web Dynpro 技术 要 点 


Web Dynpro 架构 中 包含 Web Dynpro 2HfF. UI 元 素 、 窗 口 、 视 图 , 以 及 Context, Web Dynpro 
组 件 允许 构建 复 嫉 的 Web 应 用 程序 和 开发 可 重用 的 、 交 互 的 实体 ， 这 可 实现 大 段 应 用 程序 的 
HUE. Web Dynpro 组 件 是 与 UI 和 Web Dynpro 程序 相关 的 其 他 实体 的 容器 。 与 UI 相关 的 实 
体 是 窗口 和 视 狗 。 视 图 的 布局 是 各 户 闫 显示 的 页 面 的 矩形 部 分 “如 浏 顺 器 )。 视 网 包括 UI 元 
素 ， 如 输入 字段 和 按钮 。 发 送 到 客户 新 的 整个 页 面 可 以 设置 为 只 包含 一 个 视图 ， 也 可 以 是 多 
个 视图 的 组 合 。 可 能 的 视图 组 合 及 视图 之 间 的 数据 流 在 窗口 中 定义 。 一 个 窗口 可 以 包含 任 总 
数量 的 视图 。 一 个 视图 可 以 移入 到 任意 数量 的 窗口 中 。Web Dynpro 源 代码 位 于 Web Dynpro 
控制 嚣 中。 控制 器 全 局 变量 的 层次 存储 被 称 为 Context. 

除 上 述 基本 概念 外 ，Web Dynpro 应 用 多 与 其 他 技术 集成 用 以 满足 用 户 的 需求 ; 在 SAP 
NetWeaver FS E, Web Dynpro 应 用 多 以 很 多 Web Dynpro 高 级 概念 来 弥补 SAP 用 户 对 GUI 
环境 的 依赖 并 请 足 用 户 的 新 需求 。 


党 2 全 ”集成 Adobe Flash Islands 


Adobe Flash Islands 是 基于 Adobe 的 Flex 技术 。Adobe Flex 提供 了 一 个 通用 的 开发 环境 ， 可 
用 于 创建 富 互联 网 应 用 〈(RIA)。 可 以 在 所 有 主流 浏览 吉平 侣 和 操作 系统 上 开发 并 运行 RIA 程序 。 

Adobe Flex 创建 的 应 用 程序 可 以 集成 到 的 Web Dynpro ABAP, 这 使 得 标准 的 Web Dynpro 
用 狐 的 组 件 得 到 加 强 。 这 些 狐 的 组 件 都 实现 了 与 Adobe Flex 和 相关 的 客户 端 / PC 浏览 名 上 本 
地 运行 。 一 个 Flash Islands UI 元素 可 以 艇 入 Web Dynpro 的 视图 ， 可 以 访问 Web Dynpro 的 
Context H, JF H.a LALA Web Dynpro 的 动作 (Action)。 

1. 先决 条 件 (Prerequisites) 

要 实现 的 Adobe Flash Islands 的 Web Dynpro ABAP 应 用 程序 ， 需 要 准备 以 下 内 容 : 

e 使 用 Adobe IJ Flex Builder 2 或 3( 开 发 环境 )。 

e 使 用 Adobe Flash Player 9 Update 3( 在 客户 器 上 使 用 Adobe Flash Islands 控件 )。 

e (HH SAP NetWeaver 所 提供 的 Adobe Flex 服务 。 访 服务 库 〈( 文 件 WDlsland Library.swc 或 

WDIslandLibrary-debug.swc ) 存 储 在 SAP/PUBLIC/BC/UR/nw7/Flashlslands 下 的 MIME 处 。 

e 使 用 客户 提供 的 Adobe Flash 应 用 程序 的 SWF 文件 (连同 相关 的 调试 SWF 文件 )。 

2. 操作 (Procedure) 

在 Web Dynpro 中 使 用 Adobe Flash/Flex 应 用 程序 。 它 必须 被 包 含 作 为 一 个 Flash Island 的 
UI 元素 。 这 种 包装 可 以 使 Adobde Flash 应 用 程序 与 Web Dynpro 框架 之 间 进 行 通 信 ，。 


2.1 Flash Island UI 元 素 的 数据 传输 


Flash Island 的 数据 传输 可 以 通过 一 个 例子 来 描述 。 示 例 显 示 了 一 个 条 形 图 ， 该 图 创建 于 
Adobe Flex Builder 中 ， 使 用 值 从 SAP 系统 中 取得 ， 学 科 (subject〉 和 成 绩 (test) 的 值 会 显示 
在 条 形 图 上 。 在 Web Dynpro 应 用 程序 中 ， 最 终 用 户 可 以 将 查询 的 成 绩 显示 出 来 ， 若 单 击 “ 总 
成 绩 ” 按 钮 ， 则 Adobe Flash 组 件 将 取得 Web Dynpro 应 用 程序 的 总 成 绩 及 更 新 的 条 形 图 ， 运 
行 结果 如 图 2-1 所 示 。 


班级 : * 一 年 级 A 班 | 


学 年 : 米 2009 


学 生 番号 : * 00001 P 


1. 先决 条 件 (Prerequisites) 
该 例 的 出 发 点 是 一 个 SWF 文件 (包括 调试 的 SWF 文件 ) 及 SWE 文件 的 详细 信息 ， 如 变 
量 、 列 表 和 必要 的 动作 。 


MES Flex 文件 区 分 大 小 写 。 


为 了 使 Adobe Flash 应 用 程序 和 Web Dynpro 应 用 程序 之 间 进 行 通信 , 需 配 置 Web Dynpro 
Island Library for Flex 到 所 需 的 项 目 : 

e 这 涉及 SWC 文件 WDIslandLibrary.swc 和 WDIslandLibrary-debug.Swc。 保 存 这 两 个 文 
件 到 MIME 资源 库 所 在 路 径 SAP/PUBLIC/BC/UR/mw7/Flashlslands/ 下 ， 以 便 可 以 随时 
访问 它们 。 

e 将 它们 保存 在 Adobe Flex Builder 下 构建 的 路 径 。 

€ ZE Adobe Flex 编码 需要 时 导入 Flash Islands Jë: (import sap.Flashlsland) 

e 为 了 数据 传输 能 够 正常 进行 ,在 Adobe Flex 应 用 程序 中 使 用 FlashIsland.register 
(«component name») 语句 注册 相关 的 Adobe Flex 组 件 。 

2. 操作 (Procedure) 

€ 导入 SWF 文件 及 其 调试 的 SWF 文件 。 

e 在 Web Dynpro 应 用 程序 中 定义 与 Adobe Flex 应 用 程序 中 相同 名 称 的 Context 属性 。 

e 在 调用 Flash Island 之 六 编辑 Context 节点 ， 如 供给 函数 。 

e 编辑 显示 Flash Island 控件 的 视图 。 


22 Flash Island Ul 元 素 的 事件 


1. 先决 条 件 (Prerequisites) 

在 使 用 数据 传输 例子 的 SWF 文件 中 ， 有 一 个 附加 的 功能 ， 可 以 单 击 按钮 以 改变 在 Flash 
Island 值 。 

2. 操作 (Procedure) 

在 Web Dynpro 应 用 程序 中 使 用 Flash Island 的 事件 ， 意 味 看 在 Flash Island 事件 被 触发 时 ， 
这 个 事件 把 合计 作为 一 个 字符 串 参 数 传 给 Web Dynpro 应 用 程序 。 访 事件 称 为 onClickButton。 

1) 在 Web Dynpro 应 用 程序 集成 的 Flash Island UI 元 素 中 添加 一 个 GACEvent。 

2) GACEven 元 素 必 须 设 定 以 下 属性 什 。 

€ name: onClickButton. 

€ OnAction: 相关 的 Web Dynpro 动作 。 

3) W GACEvent 参数 GACEventParameter 76 z& HJ 4 PK Ja PE Je HIA Jes THE UU BU T9139] 
的 类 型 。 

4) WDEvent 使 用 动作 处 理 程序 方法 得 到 参数 在 Web Dynpro 应 用 中 做 相关 处 理 。 


2.9 编辑 Adobe Flex 应 用 程序 


1) 启动 Adobe Flex 编辑 器 ， 在 Flex 工程 编辑 界面 创建 Flex 工程 ， 如 图 2-2 Pr. 


^" New Flex Project 


Create a Flex project. 


Choose a name and location for your project, and configure the server technology your project will be using. 


Project name: |TestjlDIsland 


-Project location 


[]Use default location 
Folder: D: workspaceXTestWDIsland 


—Application type 


@ [A "eb application (runs in Flash Player) 
O [fj Desktop application (runs in Adobe AIR) 


-Server technology 


Application server type: 


|V|Use remote object access service 


i 'LiveCycle Data Services 


ColdFusion Flash Remoting 


Q Learn more about configuring a Flex project to work with your server technology. 


mais == 


2-2 


单 击 [ meo | 按钮 ， 显 示 编 译 路 径 设 定 对 话 框 ， 如 图 2-3 所 示 。 
设 定编 译文 件 路 径 并 单 击 [met > | 按钮 , 显示 编译 路 径 设 定 对 话 框 (文件 及 集成 环境 )， 
如 图 2-4 所 示 。 


^^ New Flex Project T New Flex Project 


Create a Flex project. 
Set the build paths for the new Flex project. 


Configure Üutput 
Specify the folder where your compiled Flex application will be output. 


-Compiled Flex application location E Source path BÀ Library path 
This folder will be inside your project folder. 


Framework linkage: |Merged into code 
Output folder: bin-debug | (Browse... | 


Build path libraries: 


H- Flex 3.2 - d:\FlexBuilder3Plue-in\sdks\3.2.0 Add Project... 
H-E libs 
Add SWC Folder... 


EU MN 


| Add Flex SDK 


Edit... 


Remove 


Up 


[M] Verify RSL digests (recommended for production) 


Main source folder: sre 


Main application file: |TestFlashIsland. mxml 


Üutput folder URL: 


" [uu f xo JE oen maa 


2-3 Z| 2-4 


A Aaa sic. | 按钮 ， 添 加 编译 所 需 文件 WDIslandLibrary.swc， 如 图 2-5 所 示 。 


^^ Add SEC 


Libs/WDIslandLibrary. swe | 


图 2-5 


Phi x — | 按钮 再 单 击 |_ rinish_ | 按钮 。 
2) 在 Adobe Flex 编辑 器 中 的 工程 属性 编辑 界面 更 改 Flex 工程 属性 ， 如 图 2-6 所 示 。 


m Properties for TestWDIsland 


type filter text Flex Compiler 


Resource 
Builders Flex SDK version 


Flex Applications OUse default SDK (currently "Flex 3.2") Configure Flex SDKs... 
Flex Build Path 


Flex Compiler (SUse a specific SDK: |Flex 2.0.1 Hotfix 3 Y 
Flex Modules 


Flex Server Compiler options 


+ MyEclipse [v]Copy non-embedded files to output folder 
“e haee [ ]Generate accessible SWF file 
[v] Enable strict type checking 
[v] Enable warnings 


Additional compiler arguments: 
-locale en US 


HTML wrapper 

[Y] Generate HTML wrapper file 

[v] Require Flash Player version: |9 . [0 
[v] Use Express Install 


[v] Enable integration with browser navigation 


Restore Defaults 


图 2-6 
3) 在 Adobe Flex 编辑 器 中 的 Flex 应 用 文件 编辑 界面 ， 编 辑 并 编 详 Flex 应 用 文件 如 下 : 


<?xml version-" 1.0" encoding="utf-8"?> 
«mx:Application  xmlns:mx-"http://www.adobe.com/2006/mxml" — layout-"absolute"  initialize- 
"init()" xmlns:comp-" components. *"— 
«mx:Script^ 
«I [CDATA[ 
import sap.FlashIsland; 
import mx.collections.ArrayCollection; 
[Bindable] public var columnTest: ArrayCollection ; 


[Bindable] public var test:String ; 


[Bindable] public var tittle:String ; 
[Bindable] public var subjects:String ; 
[Bindable] public var sum:String ; 
public function init():void í 
FlashIsland.register(this); 
j 


private function doSum(event:Event):void 


i 


/定义 参数 
var param:Object = {param1:'Value 1', param2: Value 2'); 
var paraml:String ; 
// 求 和 
for(var i:int = 0;i<columnTest.length;i++) 
1 
var obj:Int = int(columnTest.getItemAt(1)|test]); 
var objl: int = obj1 + obj; 
j 
param] -String(obj1);7.test; 
FlashIsland.fireEvent(this, "onClickButton", (param:paraml j ); 


j 


IS 


«/mx:Script^ 


«mx:ColumnChart x-"101" y="10" id-"column" dataProvider-" (columnTest] "showDataTips-" true" 


«mx:verticalAxis» 
«mx:LinearAxis maximum-"100"/» 
«/mx:verticalAxis» 


«mx:horizontalAxis» 


«mx:CategoryAxis id = "columncate" categoryField-" (subjects) " dataProvider-" ( columnTest]" /> 


«/mx:horizontal Axis 
«mx:series > 
«mx:ColumnSeries displayName-" {tittle}" yField—" {test} "dataProvider-" (columnTest] /> 
«/mx:series^ 
«/mx:ColumnChart^ 
«mx:Legend dataProvider-" {column }"/> 
«mx:Button x-"101" y="440" label=" 总 成 绩 " click-"doSum(event)"/7 
«mx:TextInput x="221" y="440" editable-"false" text=" {sum} /> 


«/mx: Application» 


WE: sum 这 个 变量 应 该 作为 绑 定 变量 从 Flash Island 传递 到 Web Dynpro 应 用 程序 中 ,test、 
tittle, subjects 则 相反 。 


目 动 生 成 编译 文件 如 图 2-7 所 示 。 
k D: VworkspaceNTestWTDIslandtbin-debug mife Ea 
| 文件 外 RED SEV HAW IAW HW | Av 
OME- O- P | O s= DXR |i > X 9 |E 
| 地址 t) (C3 D: \workspace\TestHDIslandibin- debug m Ez 


X TestiDIsland. swf 
Flash Movie 
£ 273 KE 


5 THR 286 KB | 我 的 电脑 y 


图 2-7 


AC ÜETags. js 
JScript Scrip 


E ! 


9 KE 


playerProductIns... 
Flash Movie 


m Ij | 


TestWDIsland.html 
HTML Document 


KB 5 KE 


2.44 编辑 Web Dynpro 应 用 程序 


1) 启动 ABAP 工作 台 ， 在 Web Dynpro 组 件 编辑 界面 ， 创 建 Web Dynpro 组 件 。 
在 下 拉 列 表 中 选中 “Web Dynpro Comp./Intf” 选 项 ， 在 相应 的 文本 框 中 输入 程序 的 名 称 ， 
如 图 2-8 所 示 。 


Web Dynpro Comp. / Intf. * 
[ZWD. FLASHISLAND] w | Š 


2-8 


Web-Dynpro-Component ZWD FLASHISLANDA TEE. 
希望 创建 该 对 象 吗 ? 


= 


«1» «|» 


2-9 


单 击 图 2-9 Hñ ”是 | 按钮 ， 弹 出 组 件 编辑 对 话 框 ， 编 辑 组件 相 关 信息 ， 如 图 2-10 
所 示 。 


[> Web Dynpro: Component / Create Interface 


Name | WD FLASHISLAND | 
Description 学 生成 绩 检 索 | 
Type («Web Dynpro Component 


(Web Dynpro Component Interface 


Window Name W FLA aHISLAND | 
View Mame W NAIN | 


2-10 


Desorption DT DT OOOO ëO 
——— L 2l 


图 2-11 


为 组 件 中 的 相关 对 象 编写 适当 的 Description (注释 )， 如 图 2-12 所 示 。 


Object Name | | Description 


* «Pb COMPONENTCONTROLL 学 生成 绩 榨 索 --- 姐 忻 控 制 器 
= di Component Interface 


| - 4 JNTERFACECONTROL 学 生成 绩 检 索 一 -组件 控 制 器 
= ËB Interface Views 
* EJ W_FLASHISLAND 学 生成 顷 检 索 一 窗 件 


Y lE views | 
. Ed v FLASH 学 生成 绩 检 索 ---FlashIsland 
， 国 v MAIN | 学生 成绩 检 索 --- 视 图 


v I| windows | 
° EA w FLASHISLAND “| 学 生成 缚 检索 一 窗 件 


图 2-12 


2) 在 ABAP 工作 台中 的 Web Dynpro 组 件 编辑 界面 导入 Flex 编译 文件 。 
在 组 件 上 单 击 鼠 标 右 键 ， 在 弹出 的 菜单 中 单 击 “Create” 一 “Mime Object" — “Import” 
命令 ， 导 入 文件 〈 见 图 2-13)， 弹 出 如 图 2-14 所 示 的 对 话 框 。 


we oo Coroonent (tarice) 


Change View 

Display b Window 

Create/Change Configuration Custom Controller 

Check d Service Call 

Activate Create 
Copy... | Web Dynpro Application Hort —— 
Rename... 

Delete 


Where-Used List 
Other Functions 


lk] 2-13 
[c AERA 
LE NES ( 技术 信息 
O 文档 类 别 Flash 对 象 vi 
名 称 TestWDIsland.swf 
描述 | | 
XE IF:\123\TestWDIsland.swf | 
Mime 类 型 lapplication/x-shockwave-flash | m 
E 
ix) 
图 2-14 


选中 编译 完成 的 Flex 文件 ， 单 击 图 按钮 。 
3) 在 ABAP 工作 台中 的 组 件 编辑 界面 编辑 组 件 控制 占 属 性 。 


10 


EAMES E 25 ISE SR. ENH lr Attributes 编辑 如 图 2-15 所 示 。 


Component Controller COMPONENTCONTROLLER Inactive 


Description 


WD CONTEXT n (4| IF WD CONTEXT NODE Reference to Local Controller Context 
WD THIS 口 (| IF COMPONENTCONTROLLER Self-Reference to Local Controller Interface 
TEST [v] [] ZZTEST S 考试 成 绩 信 息 
[] [] 
2-15 


4) 在 ABAP 工作 台中 的 视图 编辑 界面 编辑 视图 V MAIN. 
在 左 侧 程序 的 树 形 结构 菜单 上 双击 视图 V MAIN， 选 中 “Context” 选 项 卡 ， 编 辑 结果 
如 图 2-16 所 示 。 


View V MAIN Inactive 
Properties Layout Inbound Plu Outbound Plu Attributes Actions Methods 
Context V MAIN | KzWD FLASHISLAND.COMPONENTCONTROLLER ` 
7 O CONTEXT Context COMPONENTCONTROLLER 
TE |. * O CONTEXT 

* B ZZCLASS : 

* ® ZZYEAR 

* $ ZZSTDNO 

* B ZZNAME 
Property aue — Transfer attri.. 
Node Name NODE CONDITION 
Dictionary structure ZZTEST S 
Cardinality 1.3 Ee 
Selection 0..1 Ë! 
Initialization Lead Selection [v 
Singleton 口 
Supply Function 

2-16 
` é ”> 、 M +H EN — 
选中 “Outbound Plugs” 选 项 卡 ， 编 辑 出 站 插头 如 图 2-17 所 示 。 
View V MAIN Active 
Properties Layout Inbound Plugs Context Attributes Actions Methods 


Plug Name Description 
TOFLASH Adz FlashIsLand 


217 


选中 “Layout” 选 项 卡 ， 纲 辑 得 询 条 件 信 息 ， 并 添加 视图 容器 UI 元 素 如 图 2-18 MR. 


[=> Create element 


ID "CU FLA SH I | 
Typ | ViewCantainerUTIElement á | 


2-18 
11 


编辑 结果 如 图 2-19 所 示 。 


View V MAIN Active(revised) 
Inbound Plugs | Outbound Plugs context V Attributes | / Methods | 


* L] coNTEXT. MENUS 
~ C] ROOTUIELEMENTCONTAINER 


v 


| 班级 : m 一 年 级 A 班 M * T CAPTION [Header] 
* T ZZCLASS LBL 
' 学年: * V. MAIN.NODE CONDIT| « Bl ZZCLASS 
。 T ZZYEAR LBL 
| 学 生 番 号 : [V MAIN.NODE CONDITÍB V MAIN.NODI rac 
: RE EUER GERE SPREAD MEME * T ZZSTDNO LBL 
ViewContainerUlElement: VCU FLASH * è ZZSTDNO 
- E] ZZNAME 
* = BTN SEARCH 
* F] vcu FLASH 
Property ——Á—Ü B 
Properties (Group) 
ID 
Layout MatrixLayout zl 
accessibilit... C] 
图 2-19 


X “BTN SEARCH” 按 钮 编辑 动作 GET TEST 如 图 2-20 所 示 。 


[=> Create Action 


Component ZWD FLASHISLAND 
View "V MAIN 

Action IGET TEST 
Description EIE: 


Select an outbound plug or enter an 
outbound plug for leaving the view 
by selecting the pushbutton 
Outbound Plug | 


图 2-20 


动作 GET TEST 处 理 方 法 编辑 如 下 : 


METHOD ONACTIONGET TEST. 
DATA LO ND NODE CONDITION TYPE REF TOIF WD CONTEXT NODE. 


DATA LO EL NODE CONDITION TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LS NODE CONDITION TYPE WD THIS--ELEMENT NODE CONDITION. 


* navigate from «CONTEXT» to «NODE CONDITION? via lead selection 


LO ND NODE CONDITION = WD CONTEXT--GET CHILD NODE( NAME = WD THIS-> 
WDCTX NODE CONDITION). 


* get element via lead selection 
LO EL NODE CONDITION - LO ND NODE CONDITION->GET _ ELEMENT( ). 


* get all declared attributes 
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LO EL NODE CONDITION--GET STATIC ATTRIBUTES( 
IMPORTING 
STATIC ATTRIBUTES = LS NODE CONDITION ). 
* 取得 成 绩 信息 
SELECT SINGLE  * 
FROM ZZTEST V 
INTO CORRESPONDING FIELDS OF WD COMP CONTROLLER--TEST 
WHERE ZZCLASS = LS NODE CONDITION-ZZCLASS 
AND ZZYEAR -LS NODE CONDITION-ZZYEAR 
AND ZZSTDNO - LS NODE CONDITION-ZZSTDNO. 


s set single attribute 
LO EL NODE CONDITION-^SET ATTRIBUTE( 

NAME = "ZZNAME' 
VALUE = LS NODE CONDITION-ZZNAME ). 


WD THIS->FIRE TOFLASH PLG( 
). 


ENDMETHOD. 


5) 在 ABAP 工作 人 台中 的 视图 编辑 界面 编辑 视图 V_FLASH。 
在 左 侧 程序 的 树 形 结构 菜单 上 双击 视图 V_ FLASH， 选 中 “Context” 选 项 卡 ， 编 辑 结 
果 如 图 2-21 所 示 。 


View Y FLASH Inactive(revised) 
Properties | Layout \ Inbound Plugs | Outbound Plugs Z Context | Attributes | Actions V Methods ` 
Context V. FLASH ¿Z ZWD FLASHISLAND.COMPONENTC 
* O CONTEXT Context COMPONENTCONTROLLER 
Y [5] NODE TEST . C) CONTEXT 
* $ SUBJECTS 
* 5 TEST 
* $ SUM 
Property Value 
Attribute Name TITTLE 
Type assignment Type 
Type STRING 
Read-only m 
Default Value 成 绩 
Null--Wert m 
Wertehilfe-Modus Automatic 


图 2-21 


it: Æ Context 中 定义 的 变量 要 和 在 Flashlsland 定义 的 变量 一 致 ， 否 则 变量 值 无 法 
传递 。 


选中 “Inbound Plugs” 选 项 卡 ， 编 辑 入 站 插头 如 图 2-22 Br. 
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View 'Y FLASH | Active 


“Outbound Plugs V Context | Attributes ^ Methods 


LE Plug Name Description Event Handler 
I IF ROMMATN fib FlashIsLand HANDLEFROMMAIN 
II ] 
图 2-22 


选中 “Layout” 选 项 卡 ， 选 中 右 侧 的 根 节点 “ROOTUIELEMENTCONTAINER”， 单 击 鼠 
标 右 键 ， 按 照 图 2-23 所 示 的 路 和 任 转换 UI 7028 2870 。 
选中 变换 属性 为 “FlashIsland”， 弹出 如 图 2-24 所 示 的 对 话 框 。 


Insert Element [=> Create element 


Create Container Form ID ROOTUIELENENTCONTAINER | 
Display UI Element Document Typ TT: | 
目 : š di 


Delete Child Elements from Root 


图 2-23 图 2-24 
变换 后 属性 编辑 如 图 2-25 所 示 。 
a ROOTUIELEMEHTCON TAINER 
enabled [vi 
height 450px 
sufrie {ZWD_FLASHISLAND}/TestWDIsland.swf ， 
tooltip 
visible Visible El 
width B00px 
图 2-25 


选中 右 侧 的 根 目 录 “ROOTUIELEMENTCONTAINER”， 单 击 和 鼠标 右键 ， 按 照 图 2-26 所 
示 的 路 径 创 建 UI 元 素 GACDATASOURCE、GACEVENT 和 GACPROPERTY。 


IMSERT DATA SOURCE 
IMSERT EVENT 

IMSERT PROPERTY 

Display UI Element Document 


Delete Child Elements from Root 


Swap Root Element 


图 2-26 


选中 创建 的 UI 763€ *GACEVENT [Events]” 单 击 鼠 标 右键 ， 按 照 图 2-27 所 示 的 路 径 创 
建 事件 的 参数 。 
编辑 结果 如 网 2-28 所 示 。 


14 


。 [.] conTExT. MENUS 


x IMSERTEVENT PARAMETER —— ~  ROOTUIELEMENTCONTAINER 


~ Q^ GACDATASOURCE [DataSources] 


MOVE UP 

DUM * @ GACPROPERTY 1 [Properties] 
m * @ GACPROPERTY 2 [Properties] 
Display UI Element Document AC $ GACEVENT [Events] 


* |@ GACEVENTPARAMETER 
* Q9 GACPROPERTY 
DELETE EVENT * Q9? GACPROPERTY SUM 


Copy Element 


图 2-27 图 2-28 


it: GACDataSource H FARZ Context 节点 ， 与 Flex 文件 中 的 columnTest 相对 应 。 
GACProperties A FRÆ Context 站 点 中 的 属性 ， 对 应 Flex 文件 中 的 变量 。GACEVENT 用 于 
绑 定 视图 中 的 Action， 对 应 Flex 文件 中 的 事件 onClickButton。 实例 中 相关 的 属性 设 定 见 表 2-1. 


Property Value Bi... 

ID GACDATASOURCE 

| | —— name 
dataSource — V FLASH.NODE TEST | &é- 


readOnly 四 readOnly 


name calumn Test | 
value ey value 


Property Value 


GACEVENTPARAME... 


erties (GACPropert | 
ID GACPROPERT Y 
name tittle sum 
readOnly 四 mm readOnly 四 


y - 
value V_FLASHTITTLE — [@ | value 


选中 “Action” 选 项 卡 ， 新 建 动作 GET NUM 如 图 2-29 所 示 。 


LE Create Action 


Component ZWD FLASHISLAND | 
view IV FLASH | 
Action GET SUM | 


Description 求 得 成 缚 总 和 


[ Transfer LII Event Parameters 


图 2-29 


编辑 结果 如 图 2-30 所 示 。 


zs 


V FLASH Active 
/ Attributes ^" Actions | Methods 


View 
Properties «^ Layout 7 Inbound Plugs 7 Outbound Plugs ~ Context 


E|] [32 a|) (e Eu) [ra] o | M) 
Action Action Type Description Event Handler 
r 5 ， 
GET SUM| p Stand. Y 求 得 成 绩 总 和 ONACTIONGET SUM 
lk 2-30 


动作 对 应 事件 处 理 程序 编辑 如 下 : 


METHOD ONACTIONGET SUM. 


DATA LO EL CONTEXT TYPE REF TOIF WD CONTEXT ELEMENT. 


DATA LS CONTEXT TYPE WD THIS--ELEMENT CONTEXT. 
DATA LV SUM TYPE WD THIS--ELEMENT CONTEXT-SUM. 


* get element via lead selection 
LO EL CONTEXT = WD CONTEXT->GET ELEMENTN( ). 


* @TODO fill attribute 
WDEVENT-»-GET DATA( 
EXPORTING 
NAME -'param' 
IMPORTING 
VALUE - LV SUM 


). 
* set single attribute 
LO EL CONTEXT-^SET ATTRIBUTE( 


NAME = "SUM? 
VALUE = LV. SUM ). 


ENDMETHOD. 
选中 “Methods” 选 项 卡 ， 入 站 插头 FROMMAIN 处 理 程序 如 下 : 


method HANDLEFROMMAIN . 
DATA LO ND NODE TEST TYPE REF TO IF WD CONTEXT NODE. 


DATA LS NODE TEST TYPE WD THIS--ELEMENT NODE TEST. 
DATA LT NODE TEST TYPE WD THIS--ELEMENTS NODE TEST. 


navigate from «CONTEXT to «NODE TEST> via lead selection 


* 
LO ND NODE TEST-WD CONTEXT->GET CHILD NODE(NAME-WD THIS-WDCTX NODE TEST) 


LO ND NODE TEST->INVALIDATE( ). 


* (QTODO compute values 
MOVE ' 语 文 'TO LS NODE TEST-SUBJECTS. 
MOVE WD COMP CONTROLLER-^TEST-ZZTENKOK TO LS NODE TEST-TEST. 
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APPEND LS NODE TEST TOLT NODE TEST. 

MOVE 数学 'TO LS NODE TEST-SUBJECTS. 

MOVE WD COMP CONTROLLER-»TEST-ZZTENSAN TO LS NODE TEST-TEST. 
APPEND LS NODE TEST TOLT NODE TEST. 

MOVE ' 自 然 'TO LS NODE TEST-SUBJECTS. 

MOVE WD COMP _ CONTROLLER->TEST-ZZTENRIK TO LS NODE TEST-TEST. 
APPEND LS NODE TEST TOLT NODE TEST. 


MOVE 7A TO LS NODE TEST-SUBJECTS. 
MOVE WD COMP CONTROLLER-^TEST-ZZTENSHA TO LS NODE TEST-TEST. 
APPENDLS NODE TEST TOLT NODE TEST. 
* 
LO ND NODE TEST->BIND TABLE( NEW ITEMS -LT NODE TEST SET INITIAL ELEME 
NTS= ABAP FALSE ). 
endmethod. 


6) 在 ABAP 工作 台中 的 窗 体 编辑 界面 编辑 视图 则 导航 链接 。 
在 左 侧 程 序 的 树 形 结构 菜单 上 双击 窗 体 W_FLASHISLAND， 选 中 “Window” 选 项 卡 ， 
编辑 导航 如 图 2-31 所 示 。 


W FLASHISLAND Active 
V Inbound Plugs V Outbound Plugs V Context V Attributes Methods | 
Window-Struktur Description 
~ C W. FLASHISLAND 
> 国 v MAIN 学 生成 绩 检 索 --- 视 图 
~ Ej]vcu FLASH 
> 图 v_FLASH 学 生成 绩 检 索 ---FlashIsland 
* €Z FROMMAIN libe Flash IsLand 
~ Ë? TOF| ASH lib: FlashIsLand 
B | 
* S3 DEFAULT 
图 2-31 


7) 在 ABAP 工作 台中 的 Web Dynpro Application 编辑 界面 创建 Web Dynpro Application, 
如 图 2-32 所 示 。 


[=> Create Web Dynpro application 


Application mwd fashsand — 1] 
Description 学 生成 绩 查 询 | 


图 2-32 
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qaum 文件 操作 


Web Dynpro 应 用 程序 可 以 使 用 FileDownload 控件 导出 的 文件 ， 从 而 实现 通常 的 安全 要 求 。 
该 下 载 的 功能 在 任何 一 个 操作 处 理 程序 中 都 是 可 用 的 。 例 如 , 当 单 击 一 个 的 按钮 , LinkToAction 
或 《作为 正常 的 程序 设计 不 应 该 这 样 做 ) 切换 选项 卡 TabStrip 时 或 选中 一 个 单 选 按 钮 ， 都 可 
以 进行 下 载 。 当 用 户 单 击 FileDownload 的 UI 元 素 时 ， 将 产生 二 进 制 数据 流 。 对 于 这 个 数据 
流 ， 会 产生 相应 的 URL 的 结果 并 显示 在 一 个 单独 的 浏览 器 窗 体 中 。 

(1) 特点 (Features) 

无 论 是 导出 一 个 文件 或 多 个 文件 ， 都 以 相同 的 方式 显示 数据 并 存储 文件 。 

QD 在 同一 窗口 中 显示 ， 如 图 3-1 所 示 。 


Address Æ] http:flda138.wdF.sap.corp:S0021/sapjbcIwebdynpro/sap/hvg test, events 


content of a text file 


图 3-1 
D 在 同一 窗口 中 保存 查询 ， 如 图 3-2 所 示 。 
rie Download — > 


9 Some files can harm your computer. If the file information below 
tp looks suspicious, or you do not fully trust the source, do not open or 
save this file. 
File name: file1.txt 
File type: Text Document 
From: us4049.wdf .sap.corp 


Would vou like to open the fle or save it to your computer? 


Üpen | Cancel | More Info | 
[7 P ways as DETOTE OPETTI us type ot me 


(3) 在 一 个 平行 的 窗 体 中 显示 。 

O 在 一 个 平行 的 窗 体 中 保存 查询 。 

3k: 使 用 Internet Explorer 时 ， 多 个 文件 的 保存 查询 需 通 过 外 部 窗 体 。 因 此 ， 同 时 下 载 多 
个 文件 都 是 通过 外 部 窗 体 。 


(2) 操作 (Procedure) 

使 用 类 CL WD RUNTIME SERVICES 中 的 方法 ATTACH FILE TO RESPONSE 实现 
文件 寻 出 。 

下 面 介 绍 编辑 Web Dynpro 应 用 程序 的 方法 。 

该 例 以 学 生 相 三 为 例 ， 将 学 生 相 记 所 在 文件 上 传 到 服务 器 ， 并 通过 链接 提供 下 载 或 显示 
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在 浏览 如 中 。 


1) 启动 ABAP 工作 台 ， 在 Web Dynpro 组 件 编辑 界面 创建 组 件 ， 如 图 3-3 所 示 。 


LE Web Dynpro: Component / Create Interface 


Name 


Description 


| AWD TEST FILE | 
ETT Bore | 


Type 


(e Web Dynpro Component 


(Web Dynpro Component Interface 


Window Mame 


W TE aI FILE | 


View Name 


[V MAIN | 


M 


5-9 


编辑 结果 如 图 3-4 所 示 。 


Object Name | Description 


~ d ZWD TEST FILE 


TER Ef 


e 4É COMPONENTCONTROLL SEE B. LEHRE 


* da Component Interface _ 


- 4 INTERFACECONTROI SEES B. Ht Ahea 


~ FE Interface Views 
* El w TEST FILE 


= FE Views 
O e Ev MAIN. 
v IE windows 


(FEEL 


| 学 生 信 息 上 传 -视图 ， 


' 回 w_TEST FILE | 学 生 信息 上 传 一 窗 体 


3-4 


2) 在 ABAP 工作 台中 的 视图 编辑 界面 编辑 视图 。 
EAMA EARE FAM HAM, WIE "Context" MR, WI Context si. M 


zal e 


R 3-1 


NODE FILE UPLOAD 


[Œ Create Node 


Node Name NODE FILE UPLOAD 
Interface Node No - 
Input Element (Ext.) No v 
Dictionary structure 

F 本 
Cardnalty 
Selection Toi J 
Init. Lead Selection Yes ”| 
Singleton No v 
Supply Function 

基数 : 1.1 


NODE FILE DOWNLOAD 


[c Create Node 


Node Name 
Interface Node No - 
Input Element (Ext.) No | 
Dictionary structure 
Cardinality 0..n v 
Selection [0..1 ”| 
Init. Lead Selection Yes M 
z —— 
Singleton No v| 
Supply Function | 
(YW Add Attribute from Structure ||? Additional Node J[%] 
基数 : 0.n 
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属 


TE 


FILE NAME 


FILE TYPE 


FILE SIZE 


编辑 结 末 
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View 


FILE CONTENTS 


V MAIN Active(revised) 


Properties V Layout 


Context V MAIN 
Y (O CONTEXT 


-加 


NODE FILE UPLOAD 
tb FILE NAME 


* $ FILE TYPE 

* "5 FILE SIZE 

* "b FILE CONTENTS 
* "b ZZNUMBER 

* "b ZZNAME 


* $ FILE NAME 

* $ FILE TYPE 

* B FILE SIZE 

* $ FILE CONTENTS 
* "b ZZNUMBER 

* $ ZZNAME 

* "i ZZSEX 


Inbound Plugs 


Attributes 


^ Outbound Plugs 


Context COMPONENTCONTROLLER 
* (O CONTEXT 


WFE “Layout” MR, WIH UI 元素， 如 图 3-5 所 示 。 


ID [GRP_CONDITION | 
Typ | Group M | 


上 


<] 3-5 


在 组 UI 元素 下 创建 表单 如 图 3-6 所 示 。 


[E Create Context Binding for Table "GRP. CONDITION" 


Context Node 
Standard Cell Editor 
Standard Property 


Context Attribute 
FILE NAME 

FILE TYPE 

FILE SIZE 

FILE CONTENTS 
ZZNUMBER 
ZZNAME 


'V MAIN. NODE FILE UPLOAD 


a contet | 
d 


'InputField 

[value ”| 

Cell Editor of Table Column Binding ‘Name of Property to Be Bound 

InputField B E value š 

InputField & = value Ë 

InputField B E value 下 

InputField z m value B 

InputField B Vi value B 

TextViem n v === 
T = : = ; ° resi TEST 
[V] contes: Arrbute Property Sings] | IEE EI 

& 3-6 


(B) 
类 on 
STRING 
STRING 


STRING 


XSTRING 


添加 文件 上 传 UI 元素 如 图 3-7 所 示 。 


[=> Create element 


ID FUP FILE 
Tvn FileUpload * 


E 
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属性 设 定 如 图 3-8 所 示 。 


property IB... 
Proers(FleUDoad) — s s 
ID FUP FILE 

Layout Data MatrixData Ë! 
activateAccessKey 口 

contextMenuBehavi... Inherit e 
contextMenuld 

data V MAIN.NODE FILE UPLOAD.FILE CONTENTS 
enabled [v m 
explanation 
fileName V_MAIN.NODE_FILE_UPLOAD.FILE_NAME v 
mimeType V-MAIN.NODE FILE UPLOAD.FIE TYPE —— [@ 
state Normal Item e 
textDirection Inherit e 
tooltip 
visible Visible e 
width 


<] 3-8 


添加 按钮 UI zGzs ul 3-9 所 示 。 


[= Create element 


ID BIN UPLOAD 


Tvp Button k. 


vix 
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分 配 Action 如 图 3-10 所 示 。 


[c Create Action 


Component ZWD TEST FILE 
View V MAIN | 
Action UPLOAD | 


Description. | 文件 上 传 | 


Select an outbound plug or enter an 


outbound plug for leaving the view 
by selecting the pushbutton 


Outbound Plug m" 


zaa 
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动作 Action 对 应 处 理 程序 编辑 如 下 : 


METHOD ONACTIONUPLOAD . 


* Node, Structure, Table 4E X 
DATA LO ND NODE FILE UPLOAD TYPE REF TOIF WD CONTEXT NODE. 


DATA LO EL NODE FILE UPLOAD TYPE REF TO IF WD CONTEXT ELEMENT. 
DATA LS NODE FILE UPLOAD TYPE WD THIS-^-ELEMENT NODE FILE UPLOAD. 


DATA LO ND NODE FILE DOWNLOAD TYPE REF TOIF WD CONTEXT NODE. 


DATA LS NODE FILE DOWNLOAD TYPE WD THIS-—ELEMENT NODE FILE DOWNLOAD. 
DATA LT NODE FILE DOWNLOAD TYPE WD THIS--—ELEMENTS NODE FILE DOWNLOAD. 


5 navigate from «CONTEXT» to «NODE FILE UPLOAD? via lead selection 
LO ND NODE FILE UPLOAD = WD CONTEXT->GET CHILD NODE( NAME = WD THI 
S-^WDCTX NODE FILE UPLOAD). 
s: get element via lead selection 
LO EL NODE FILE UPLOAD - LO ND NODE FILE UPLOAD--GET ELEMENTY( ). 
P get all declared attributes 
LO EL NODE FILE UPLOAD--GET STATIC ATTRIBUTES( 
IMPORTING 
STATIC ATTRIBUTES = LS NODE FILE UPLOAD). 
* H Condition PI List (EA 
MOVE-CORRESPONDING LS NODE FILE UPLOAD TO LS NODE FILE DOWNLOAD. 
SELECT SINGLE 
ZZNUMBER 
ZZNAME 
ZZSEX 
FROM ZMNUMBER T 
INTO (LS NODE FILE DOWNLOAD-ZZNUMBER, 
LS NODE FILE DOWNLOAD-ZZNAME , 
LS NODE FILE DOWNLOAD-ZZSEX ) 
WHERE ZZNUMBER =LS NODE FILE UPLOAD-ZZNUMBER . 


i navigate from «CONTEXT» to «NODE FILE DOWNLOAD? via lead selection 
LO ND NODE FILE DOWNLOAD = WD CONTEXT-^»GET CHILD NODE( NAME = WD THIS-- 
WDCTX NODE FILE DOWNLOAD ). 


* *  (gTODO compute values 
LS NODE FILE DOWNLOAD-FILE SIZE- XSTRLEN( LS NODE FILE UPLOAD-FILE CONTENTS). 


APPEND LS NODE FILE DOWNLOAD TO LT NODE FILE DOWNLOAD. 


* 
LO ND NODE FILE DOWNLOAD->BIND TABLE( NEW ITEMS = LT NODE FILE DO 


WNLOAD SET INITIAL ELEMENTS = ABAP FALSE ). 
ENDMETHOD. 
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添加 托盘 UI 元 和 素 如 图 3-11 所 示 。 


在 托盘 UI 元 素 下 添加 表 UI 元 素 如 图 3-12 所 示 。 


[Æ Create element 


图 3-11 


ID IBL LIST 
Ty 


为 表 UI 元 素 创 建 绑 定 如 图 3-13 所 示 。 


LE Create Context Binding for Table "TBL LIST" 


LU r—————— M I1 
Context Node (V NAIN.NODE FILE DOWNLOAD | 区 context | 
Standard Cell Editor TextView - 
P ———srsrxrrn rc r 
Standard Property text kd 
Context Attribute Cell Editor of Table Column | Binding Name of Property to Be Bound 
FILE_NAME TextView n4] C) text EË! 
FILE_TYPE TextView i] a text EË 
FILE_SIZE TextView E 四 text El 
FILE CONTENTS FileDownload Ds] [vi data E 
ZZNUMBER TextView Ë! 四 text Ë! 
ZZNAME TextView Ë text Ë 
zzse woe a  Ez==== 
mm = fer TEST 
(v^ (B. Context Attribute Property Bindings J 
3-13 


3-12 


其 中 绑 定 的 FileDownload 元 素 属 性 绑 定 如 图 3-14 所 示 。 


Property 


ID 
activateAccessKey 
behaviour 


contextMenuBehavi.. 


contextMenuld 
data 

design 
enabled 
fileName 
imageFirst 
imageHeight 
imageSource 
imageWidth 
mimeType 
target 

text 
textDirection 
tooltip 

type 

visible 
wrapping 


Value B... 
TBL LIST FILE CONTENTS EDITOR 

D) 
auto š 
Inherit B 


V MAIN.NODE FILE DOWNLOAD.FILE CONTENTS |@ 


standard 2 
n 
V_MAIN.NODE_FILE_DOWHNLOAD.FILE_NAME = 
=" 
V.MAIN.NODE FILE DOWNLOAD.FLE TYPE — [@ 
= 

V_MAIN.NODE_FILE_DOWNLOAD.FILE_NAME ex 
Inherit = 
navigation 3 
Visible - 
B 


3-14 
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编辑 结果 如 图 3-15 所 示 。 


上 人 薛 条 件 
学 生 : |Y_MAINNODE_FILE_UPLdD -MAIN.NODE FILE UPLOAD.ZZNAME 
文件 : ||. Browse... 
学 生 信息 汇总 EC] 
= EE. 
E 
FEES 姓名 相片 太 小 
V MAIN.NODE FILE DOWNLOAD.ZZNUMBER | v MAIN.NODE FILE DOWNLOAD.ZZNAME | 男性 w v MAIN.NODE FILE DOWNLOAD FILE NAME | V. MAIN.NODE FILE DOWNLOAD FILE_SIZE 
/ MAIN.NODE FILE DOVWNLOAD.ZZNUMBER | V MAIN.NODE FILE DOWNLOAD.ZZNAME | 男性 v v MAIN.NODE FILE DOWNLOAD FILE NAME | v. MAIN.NODE FILE DOWNLOAD.FILE SIZE 
V. MAIN.NODE. FILE DOWNLOAD.ZZNUMBER | v MAIN.NODE FILE DOVWNLOAD.ZZNAME | 男性 v| v MAIN.NODE FILE DOWNLOAD FILE NAME | V. MAIN.NODE FILE DOWNLOAD.FILE SIZE 
V MAIN.NODE FIL N IUMBER | V MAIN.NODE FILE DOWNLOAD.ZZNAME | 男性 = | v MAIN.NODE FILE DOWNLOAD FILE NAME | V. MAIN.NODE FILE DOWNLOAD FILE SIZE 
V. MAIN.NODE, FILE DOWNLOAD.ZZNUMBER | v MAIN.NODE FILE DOWNLOAD.ZZNAME | 男性 v| v MAIN.NODE FILE DOWNLOAD FILE NAME | V. MAIN.NODE FILE DOWNLOADEFILE SIZE 
| allés [e] 


图 3-15 
3) Æ ABAP 工作 台中 的 Web Dynpro Application 编辑 界面 创建 Web Dynpro Application. 
编辑 结果 如 图 3-16 Pra. 


Application Izwd test file 
Description PERELE 


vix) 


图 3-16 


4) 在 ABAP 工作 台中 运行 Web Dynpro Application. 
运行 结果 如 图 3-17 所 示 。 
LER 


学 上 生 : 
xr | 浏览. 


学 生 信 息 汇 总 
一 览 

学 生 学 号 姓名 PES 相片 A^ d 
|! 00001 AREE kİ FAPicixiding zhengpq 334152 


图 3-17 
单 击 文件 链接 ， 如 图 3-18 所 示 。 


T) http:yrwwww-sap-coa:80007saprbcrwebdynpror-.- 加 回国 
WFE RHEO 查看 WW) KEA IAM ROD aw 


>> 


O- O- TLNITITUE 
地 址 (n) &) http://www. sap. com: 8000 /sap/bc/web % 转 到 une € z 


iB Internet 


图 3-18 


24 


第 4 但 ”门户 集成 (Portal Integration ) 


Web Dynpro ABAP 应 用 程序 可 以 被 集成 到 SAP 企业 门户 (SAP Enterprise Portal), tH a 
是 说 ， 它 们 可 以 绑 定 到 一 个 门户 网 站 导航 的 iView。 

这 种 把 一 个 Web Dynpro 应 用 程序 绑 定 到 一 个 门户 网 站 应 用 程序 的 编程 方法 , 适合 约束 单 
独 的 应 用 程序 的 开发 和 应 用 ， 偏 重 于 测试 目的 。 

此 外 ， 它 可 以 解决 Web Dynpro 应 用 程序 内 的 门户 功能 。 因此, 程序 员 可 以 访问 门户 网 站 
管理 方法 (接口 IF WD PORTAL INTEGRATION)， 作 为 不 同 功 能 的 源 代码 模板 ， 调 用 Web 
Dynpro 代码 向 导 。 这 些 包括 以 下 内 容 : 

1) 使 用 门户 网 站 事件 。 

2) 在 门户 网 站 内 导航 任何 Web Dynpro 应 用 。 它 支持 下 面 的 导航 类 型 : 

e 基于 对 象 的 导航 。 

@ 绝对 导航 。 

@ 相对 导航 。 

3) 使 用 WorkProtect 模式 。 


41 绑 定 到 门户 的 准备 


要 将 Web Dynpro 应 用 程序 集成 到 门户 ， 必 须 将 Web Dynpro 应 用 程序 所 在 系统 集成 到 门 
户 系 统 ， 实 现 单 点 登录 (Single-Sign-On)， 需 满足 以 下 先决 条 件 : 

1) 在 门户 系统 中 配置 一 个 用 户 ， 并 且 在 门户 中 被 分 配 到 一 个 合适 的 角色 《如 内 容 管理 角 
色 )。 该 角色 需 包 含 所 有 必要 的 授权 和 工具 使 用 。 

2) Web Dynpro 应 用 程序 所 在 的 ABAP 系统 对 于 门户 必须 是 已 知 的 。 这 一 点 是 由 于 进入 
门户 系统 访问 数据 需要 特殊 授权 ， 必 要 的 话 也 要 能 够 进入 ABAP 系统 。 在 接 下 来 的 步骤 中 ， 
将 需要 ABAP 系统 别名 ， 该 别名 需要 被 分 配 到 门户 网 站 。 

3) 接 下 来 要 测试 应 用 程序 , 程序 员 必 须 也 有 一 个 ABAP 系统 用 户 。 为 了 避免 调用 该 应 用 
程序 时 重新 登录 ABAP 系统 ， 使 用 用 户 映射 ， 可 以 连接 门 尸 网 站 与 ABAP 的 系统 。 

一 旦 这 些 技术 的 先决 条 件 得 到 满足 ， 登 录 到 门户 网 站 ， 便 可 以 在 最 初 的 导航 屏幕 功能 内 
选择 内 容 管 理 。 


注 : 有 具体 如 何 实施 基于 SAP NetWeaver EP 的 单 点 登录 请 参阅 相关 文档 。 本 例 中 将 Web 
Dynpro 应 用 程序 所 在 系统 集成 到 门户 系统 (xitst )。 


42 门户 中 Web Application 集成 


本 而 将 介绍 创建 iView 的 步骤 ， 该 iView 显示 后 台 系 统 中 运行 的 Web Dynpro ABAP 应 用 
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REF. 
1) 按照 路 径 Chttp://xitst:50000/1j). 登录 门户 系统 ， 如 图 4-1 所 示 。 


A 门户 内 容 - SAP NetWeaver Portal 


File Edit view Favorites Tools Help L| 


Q sax ~ © ix) PEA JO Search S Favorites € à š ER - lel b. 3 


Address &) http://xitst:S0000/irj/portal 


ELI | MIAU ` 
三 hp/ š 


| EF] sas 


v SE 


SES os EDT 


内 容 管理 
门户 内 容 | 多 属性 蔡 代 | AASF | web Dynpro | 活动 报表 | KM 内容 | 协作 内 容 | 工作 流 内 容 
PS | 历史 记录 。 返 回 转发 E 
EAE S Ee rl 
| nes&x =)” /| 
B8) 无 要 显示 的 项 目 y CJ Business Objects eS 
C NetWeaver 内 容 生 产 者 EMT 1 TD U j, Pt j 
-Oneng ^ igr PIT Iia far * " n " Y T 


p tr MOYA 
» 3 com.sap.ip.collaboration E JA. qr m] DT. 


LI LIE HN s. 3 


M. Paan f | 1 | "E 
» (1028033 I 
y NSP 
» C3 specialist 27711 i : Uk ^ r 
C3 Systemlandscape 
» Test 
» Test 一 
四 themes 
人 unification 5.0 
» C3 visual Composer 门户 内 容 工作 室 提 供 开 发 和 管理 门户 内 容 的 中 心 
» (713838 v | 环境: iview, 页 面 , 格式 , LER, 角色 和 数据 包 . 
All 


HFAA 
接口 结构 
XXe 
提示 


图 4-1 


在 当前 文件 夹 下 ， 用 鼠标 右键 单 击 “Context” 菜 单 中 的 “C0 
按照 图 4-2 所 示 的 路 人 径 局 动 iView [n] o 

2) 在 应 用 技术 (Application Technology) 回 导 页 中 , 选择 Web Dynpro 
ABAP 应 用 程序 ， 创 建 一 个 Web Dynpro ABAP 应 用 程序 的 1View， 如 
图 4-3 所 示 。 


iView 向导 
[3] 
源 类 型 。 页 面 创建 St 
基于 以 下 之 一 的 新 视图 : 


CMER 一 根据 现 有 视图 模板 来 创建 视图 
站 门户 组件 一 创建 包含 在 部 署 门户 归档 ( PAR ) 净 件 中 的 门户 组 件 的 视图 
(` Web Dynpro 应 用 程序 一 ”根据 部 署 Web Dynpro 应 用 程序 创建 视图 


[RE] [GEF [F=FB) [5X 
图 4-3 


注 : 此 处 可 选择 “Web Dynpro 应 用 程序 ” 单 选 按钮 来 创建 View, KARB PIA “F 
图 模板 ”选项 中 的 页 面 配置 。 
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LLL LLLLLLLLLLLLLIIILLLLLLL |] 1 11 í í í í í 
W1: 模板 选择 

CKM 讨论 组 管理 iview 四 
CKM 配置 iview 

CKM REET as iView 

CSAP BSP iView 

CSAP IAC iView 

CSAP MiniApp iview 

CSAP RFC iView 

US SAP Web Dynpro iView 

CSAP 事务 iview 

CURL iViewe 

Cuveb 服务 iview 

(XML iview 

个 代理 到 | Portlet iview (WSRP) 

个 协作 配置 模板 

个 工作 集 映射 iView 

个 服务 映射 ivieww 

个 没有 内 容 过 滤器 的 KM IEH iview [=] 


DR0] [到 各 | - — MESI 


4-4 


选中 “SAP Web Dynpro iView" Jf, md" 


步骤 2: 常规 属性 


iview 标识 : * 
iview 标识 前 绎 ( 倒 如 : com .公司 和 名称】 


E 


4-5 


HEURA RS ñ HL DoT zH, Ud 4-6 所 示 。 


步骤 3: Web Dynpro Platform 
Select whether you want to create a Web Dynpro for Java or Web Dynpro for ABAP iview 


Platform: ë 
iieb Dynpro for ABAP 
(eb Dynpro for Java 


DR] [到 可] : — EST 


Z| 4-6 


选中 “Web Dynpro for ABAP” 单 击 按钮 ， 单 击 | 下 一 个 


按钮 ， 如 图 4-7 所 示 。 


234: Web Dynpro Parameters 
Enter the parameters of the Web Dynpro application for which you want to create the iview 


System: * [4] 


Namespace: * 
Application Name: * 


Web Dynpro Client: 
(«Plain HTML 
CuwWindowes Client 
C Java Client 


Configuration Name: 


Application Parameters: Ë 


DB] [到 加 | IE |==] 
图 4-7 


HEURE SB HL FT EH, HE 4-8 Pra. 


W95: 


iview 名 称 :: 成 绩 查 询 
iview 标识 :: Test 
主语 言 :: AW 
System: SAP NSP 
wWebD'ynproNamespace: sap 
wWebDynproA&pplication:: —zwved test 
ClientType:: HTML 
DefinitionType:: ABAP 


口 当 向 导 完 成 时 将 其 打开 进行 编辑 


[HH] pm] aR] 
4-8 
MRAR, Ah ARH, ERRUR 4-9 所 示 。 


[=] kia 


Z] 4-9 


3) 选中 iView [E] siea ， 用 鼠标 右键 单 击 Context 菜单 中 的 预览 ，iView 显示 结果 
如 图 4-10 所 示 。 


| A RSH - Nicrosoft Internet Explorer 

TFE GB (E) SEV kE IAO 帮助 出) 

|Q &IB - - ix] | 到 i 搜索 收藏 夹 O| 0 2E 

地 址 0) pe f /xitst. sap. com: 50000/ir j/servlet/prt/portal/prtroot/pcd!3aportal content!2£NSP!2fTest?sap-config-mode-true 


成 绩 查 询 条 件 


| HESR: | El 
学 年 : |2009 [I 


| 成 绩 查 询 结果 


.| ”显示 详细 更 新 详细 
| FERE EZ Erkka ”数学 成 绩 “自然 成 绩 ” 思 品 成 绩 


图 4-10 


43 门户 事件 CPortal Events) 


在 SAP Enterprise Portal 中 ， 程 序 员 可 以 在 相同 的 门户 页 面 上 处 理 不 同 应 用 类 型 的 特殊 
iView。 在 这 里 ，iView 可 以 是 使 用 不 同 技术 的 应 用 (如 Web Dynpro ABAP/Java 或 BSP)。 这 
些 iView 之 间 的 通信 可 以 通过 事件 功能 门户 事件 (或 客户 问 事 件 ) 实现 。 

一 个 Web Dynpro ABAP 应 用 程序 可 注册 门户 网 站 事件 。 以 这 种 方式 ，Web Dynpro 应 用 
程序 可 以 处 理 在 门户 网 站 的 男 一 个 iView 触发 的 事件 。 因 此 ， 这 里 的 应 用 程序 基于 什么 样 的 
技术 与 iView 无 天。 因为 事件 处 理 程序 在 被 调用 时 分 配 ， 这 个 事件 发 生 时 ， 访 分 配 被 存储 在 
Web Dynpro 应 用 程序 中 ， 访 应 用 程序 已 注册 其 本 喘 到 门户 网 站 的 事件 中 。 

与 注册 事件 一 样 ，Web Dynpro 应 用 程序 可 以 触发 任何 门户 网 站 的 事件 。 在 这 种 情况 下 ， 
该 事件 由 各 目的 iView 传递 到 门户 网 站 。 门 户 网 站 把 事件 传送 到 已 注册 此 事件 的 所 有 iView。 
有 反 过 来 ， 基 于 View 的 程序 最 终 处 理 的 事件 可 以 用 其 他 技术 和 触发， 当然 也 可 以 是 Web Dynpro 
应 用 程序 。 


注 : 在 iView 之 间 的 门户 事件 功能 都 发 生 在 同一 浏览 器 窗口 中 。 在 不 同 的 浏览 器 窗口 之 
间 的 iView 不 能 接收 对 应 事件 。 

所 有 参与 事件 传递 的 iView 也 必须 属于 同一 个 域 的 。 否则 ， 由 于 JavaScript 的 限制 ， 门 户 
网 站 事件 不 能 工作 。 


4.3.1 触发 门户 事件 


在 一 个 Web Dynpro 应 用 程序 所 在 iView 内 触发 门户 事件 , 然后 该 事件 被 传递 到 门户 网 站 
的 一 个 或 多 个 其 他 的 ivView， 并 且 该 门户 网 站 将 事件 传 给 已 注册 此 事件 的 所 有 iView。 以 这 种 
方式 ， 事 件 可 以 在 不 同 技术 开发 的 iView 之 间 传 输 数据 。 
实现 门户 事件 之 间 的 iView 必须 在 同一 浏览 费 窗 口中 。 不 同 的 浏览 器 窗口 的 iView 中 事 
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件 之 间 不 能 被 触发 。 

所 有 参加 触发 或 相应 的 事件 也 必须 属于 同一 个 域 的 。 人 否则 ， 门 户 网 站 事件 不 能 工作 ， 由 
T JavaScript 的 限制 。 

在 Web Dynpro ABAP 中 ， 门 户 管理 器 GZH IF WD PORTAL INTEGRATION) 提供 了 
触发 方法 , 程序 员 可 以 根据 应 用 程序 的 要 求 用 Web Dynpro 代码 向 导 将 这 个 方法 调用 的 模板 插 
入 到 源 代 人 码 中 。 


METHOD ONACTIONFIRE PORTAL EVENT . 
DATA: L. API COMPONENT TYPE REF TO IF WD COMPONENT, 
L PORTAL MANAGER TYPE REF TO IF WD PORTAL INTEGRATION. 
L API COMPONENT = WD COMP CONTROLLER-WD GET API(). 
L PORTAL MANAGER = L API COMPONENT--GET PORTAL MANAGER( ). 


L PORTAL MANAGER--FIRE( 
PORTAL EVENT NAMESPACE -'my namespace for Web Dynpro documentation 
PORTAL EVENT NAME - 'showCustomer' 
PORTAL EVENT PARAMETER = CUSTOM ID). 
ENDMETHOD. "ONACTIONFIRE PORTAL EVENT 


除了 强制 性 参数 Namespace 和 Name， 也 可 以 传递 其 余 定 制 参数 ， 见 表 4-1. 


表 4-1 
说 HJ 接收 字符 串 
事件 的 命名 空间 PORTAL EVENT NAMESPACE 
事件 名 称 PORTAL EVENT NAME 
参数 PORTAL EVENT PARAMETER 


程序 员 可 以 从 Web Dynpro 应 用 程序 中 的 任何 位 置 触发 这 样 的 门户 事件 。 该 事件 被 发 送 到 
客户 端 ， 甚 至 还 可 以 在 一 个 请 求 啊 应 周期 内 触发 儿 个 门户 网 站 的 事件 。 

通常 情 况 下 是 在 Web Dynpro 应 用 程序 的 一 个 动作 处 理 程序 来 触发 一 个 门户 事件 。 例 如 ， 
用 一 个 动作 处 理 程序 的 UI 元素 (如 一 个 按钮 ) 触发 门户 事件 。 当 一 个 门户 网 站 的 事件 被 触发 
上 时， 首先 通过 一 个 内 部 的 应 用 程序 将 事件 从 iView 传递 到 门户 ， 同 时 会 被 门户 内 的 一 个 或 几 
个 1View 处 理 。 

事件 的 命名 罕 间 和 名 称 的 字符 限制 于 SAP 企业 门户 、 客 户 新 架构 的 命名 宇 间 。 只 可 以 使 
HÆ 4-2 中 列 出 的 字符 。 


X 4-2 
大 写字 母 A" -"Z 
小 写字 母 a" - "Z 
数值 Q" - "9 


i: 
e 必须 首先 用 字符 串 urn 命名 空间 。 
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e ¿>Z = R] com.sapportals.portal 和 com.sapportals 作为 SAP 保留 命名 空间 ， 因 此 不 能 使 
用 它们 作为 自己 应 用 程序 的 命名 空间 。 
e 命名 空间 和 名 称 是 区 分 大 小 写 的 ， 如 com.sap.webdynpro.testApplications.testEvent. 


4.3.2 ”注册 并 处 理事 件 


(1) 注册 门户 事件 
要 注册 Web Dynpro 应 用 程序 的 门户 网 站 事件 ， 可 用 接口 正 WD PORTAL INTEGRATION 
的 方法 SUBSCRIE EVENT. 


注 : 
e 门户 网 站 管理 器 中 删除 已 注册 的 门户 网 站 事件 ， 使 用 方法 UNSUBSCRIBE EVENT. 
e 门 己 事件 的 注册 登记 或 删除 操作 必须 在 每 个 视图 各 自 方 法 WDDOINIT 中 进行 。 


使 用 的 Web Dynpro 代 人 码 向 导 生成 一 个 模板 。 程 序 员 可 以 根据 实际 编辑 注册 代码 。 


METHOD WDDOINIT . 
DATA: L API COMPONENT TYPE REF TO IF WD COMPONENT, 
L PORTAL MANAGER TYPE REF TO IF WD PORTAL INTEGRATION, 
VIEW TYPE REF TOIF WD VIEW CONTROLLER. 
L API COMPONENT = WD COMP CONTROLLER-;WD GET API(). 
L PORTAL MANAGER = L API COMPONENT--GET PORTAL MANAGER( ). 
VIEW ?= WD THIS->WD GET API(). 


L PORTAL MANAGER-^SUBSCRIBE EVENT( 

PORTAL EVENT NAMESPACE = 

my namespace for Web Dynpro documentation' 

PORTAL EVENT NAME - 'showCustomer' 

VIEW = VIEW 

ACTION = 'RECIEVE CUSTOMER ID' ). 
ENDMETHOD. "WDDOINIT 


AN SEA FB am 4A [i] R, 04428 daa pH riypi upa le J. 8h. 5j 
入 的 动作 ACTION， 访 动作 用 来 触发 门户 网 站 的 事件 。 


iki: 2)4E RECEIVE CUSTOMER ID 在 视图 中 的 “Actions” 选 项 卡 中 创建 ， 用 它 可 以 判 
断 门 户 事件 的 触发 点 。 


(2) 处 理 门户 事件 

一 个 门户 事件 参数 传递 的 方法 是 通过 操作 参数 WDEVENT 的 函数 GET. STRING 进行 的 。 通 
过 可 选 参数 PORTAL EVENT PARAMETER， 可 以 取得 应 用 程序 传递 给 处 理 程序 方法 的 信息 。 在 
下面 的 示例 中 ， 一 个 特定 客户 的 成， 其 值 被 传递 到 组 件 控制 器 的 方法 SHOWCUSTOMER. 


METHOD ONACTIONRECIEVE CUSTOMER ID. 
DATA: EVT NAME TYPE STRING, 


CUST ID TYPE SCUSTOM-ID. 
EVT NAME = WDEVENT--GET STRING( NAME - PORTAL EVENT NAME ). 
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IF EVT NAME = 'showCustomer'. 
CUST ID = WDEVENT--GET STRING( NAME - PORTAL EVENT PARAMETER! ). 
WD COMP CONTROLLER-^;SHOWCUSTOMER( CUSTOMER ID = CUST ID ). 


ENDIF. 
ENDMETHOD. "ONACTIONRECIEVE CUSTOMER ID 


44 事件 应 用 实例 


本 的 示例 将 通过 一 个 页 面 显示 班级 条 件 查 询 和 班级 群体 得 询 结 末 《〈 两 个 View 分 别 为 
不 同 的 应 用 程序 中 的 视图 )， 在 两 个 视图 之 间 通 过 事件 参数 传递 值 。 


4.4.1 创建 应 用 程序 


(1) 三 询 应 用 程序 
1) 启动 ABAP 工作 台中 的 Web Dynpro 编辑 界面 ， map 
创建 Web Dynpro 组 件 。 EwD CLASS SEARCH [mee] 
选中 “Web Dynpro Comp./Intf.” AAWE Eso [1T Ft E89 183]. [g] 
中 输入 程序 的 名 称 ， 如 图 4-11 所 示 。 
创建 Web Dynpro 组 件 如 图 4-12 所 示 


图 4-11 


LE Web Dynpro: Component / Create Interface 

Marne | LWD CLASS SEARCH | 
Description BESTE RE o dg 

Type (Web Dynpro Component 


Oweb Dynpro Component Interface 


window Name W CLASS SEARCH 
]——_ 
" N pi l H 


Yew Mame 


图 4-12 
编辑 Web Dynpro 组 件 如 图 4-13 所 示 。 
Object Name Description 
~ dj ZWD CLASS SEARCH HEREDEN 


- vb CONPONENTCORNTROLLER HEST plz rare cg----:H ETT TIE 
* d Component Interface 
- b INTERFACECONTROLLER — | HESE Bl; ra cg----SHTH To BI SE 
- El Interface Views | 
* E W CLASS SEARCH | 班 锋 成 员 查询 ---- 窗 体 


Y LEJ Views | 
* Ej v MAIN BEST RES Eo r8] LEE] 
- B Windows 


图 4-13 
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2) 在 ABAP 工作 台中 的 视图 编辑 界面 编辑 视图 。 
选择 视图 V MAIN, F% “Context” WMF, Hwt Context 如 图 4-14 所 示 。 


View V MAIN Inactive(revised) 


^ Outbound Plugs E^: 


“Attributes | Action Methods 


- Properties Inbound Plugs 


v O CONTEXT Context COMPONENTCONTROLLER 
gn iin 


4-14 


Context 节点 NODE CLASS 设 定 如 图 4-15 所 示 。 


[=> Change Made 


Mode Mame 


Interface Mode Na 


Input Element (Ext. ) No o v] 
Dictionary structure ZTTEST T f | 


Cardinality Tad bó 
Selectian DO. "| 
Init, Lead Selection Yes hd 
Singleton (No - 


Supply Function | | 
Mapping Path | | 
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选中 “Layout” 选 项 卡 ， 插 入 UI 元 素 如 图 4-16 所 示 。 
编辑 布局 如 图 4-17 所 示 。 


* [ ] CONTEXT. MENUS 

™ L] ROOTUIELEMENTCONTAIMER. 
L | GRP. CLASS 

* T CAPTION [Header] 


" I ZzZCLASS_LBL 


hd 


- El zzCLASS HEEREN 
ee WB —EHAXE [9| 


j pe eal 学 年 : [v MAINNODE CLASS zi iH 


4-16 4-17 


为 按钮 深 加 动作 如 图 4-18 所 示 。 


[E Create Action 
Component ZWD CLA oo oERARCH 
View V MAIN 
Action SEARCH 
[r — — zl 


Description | 


Select an outbound plug or enter an 

outbound plug for leaving the view 

by selecting the pushbuttan 

Outbound Plug | 


图 4-18 
动作 处 理 程序 编辑 如 下 : 


METHOD ONACTIONSEARCH . 
* XE X. Context 操作 变量 
DATA LO ND NODE CLASS TYPE REF TOIF WD CONTEXT NODE. 


DATA LO EL NODE CLASS TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LS NODE CLASS TYPE WD THIS--ELEMENT NODE CLASS. 
DATA LS ZTTEST T TYPE ZTTEST T. 
定义 Portal 事件 操作 变量 
DATA LO API COMPONENT TYPE REF TO IF WD COMPONENT. 
DATA LO PORTAL MANAGER TYPE REF TO IF WD PORTAL INTEGRATION. 
DATA LV PARAMETER TYPE STRING. 
navigate from «CONTEXT» to «NODE CLASS- via lead selection 
LO ND NODE CLASS = WD CONTEXT-^GET CHILD NODE( NAME = WD THIS-^WDCTX N 
ODE CLASS ). 


(QTODO handle non existant child 
IF lo nd node class IS INITIAL. 
ENDIF. 


get element via lead selection 
LO EL NODE CLASS - LO ND NODE CLASS->GET ELEMENTN( ). 
(QTODO handle not set lead selection 
IFLO EL NODE CLASS IS INITIAL. 
ENDIF. 
get all declared attributes 
LO EL NODE CLASS->GET STATIC ATTRIBUTES( 
IMPORTING 
STATIC ATTRIBUTES = LS NODE CLASS). 
取 值 不 为 空 的 前 提 下 
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CHECK LS NODE CLASS IS NOT INITIAL. 
* 判断 数据 是 否 存 在 
SELECT * FROM ZTTEST T 
INTO LS ZTTEST T UP TO 1 ROWS 
WHERE ZZCLASS = LS NODE CLASS-ZZCLASS 
AND ZZYEAR -LS NODE CLASS-ZZYEAR . 


ENDSELECT. 
* 存在 的 场合 
IF SY-SUBRC = 0. 
CONCATENATELS NODE CLASS-ZZCLASS LS NODE CLASS-ZZYEAR INTOLV. PARAMETER. 
LO API COMPONENT = WD COMP CONTROLLER-WD GET API(). 


LO PORTAL MANAGER = LO API COMPONENT--GET PORTAL MANAGER( ). 


LO PORTAL MANAGER--FIRE( 
PORTAL EVENT NAMESPACE = 'um:com.sap.webdynpro.portalintergration.sShowClassNumber 
PORTAL EVENT NAME ='showClassNumber' 
PORTAL EVENT PARAMETER = LV PARAMETER 
"PORTAL EVENT SCOPE | - IF WD PORTAL INTEGRATION--CO EVENT SCOPE- 
CURRENT WINDOW 
JE 
ENDIF. 
ENDMETHOD. 


3) Æ ABAP 工作 台中 的 Web Dynpro Application 编辑 界面 ， 创 建 Web Dynpro Application, 
如 图 4-19 所 示 。 


[=> Create Web Dynpro application 


Application [awd class search 


Description 


图 4-19 


(2) 查询 结果 应 用 程序 
1) 启动 ABAP 工作 台 ， 在 Web Dynpro 编辑 界面 创建 Web Dynpro 组 件 。 
选择 “Web Dynpro Comp-/Intf.", 在 相应 的 文本 框 中 输入 程序 的 名 称 ， 如 图 4-20 所 示 。 


Web Dynpro Comp. F Intf, ~ 
[WD CLASS RESULT EAE 
ERA] 


图 4-20 
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创建 Web Dynpro 组 件 如 图 4-21 所 示 。 


[E Web Dynpro: Component / Create Interface 

Mame | ZWD CLÀ os RE SULT | 
Description HSN p: ror cal. 

Type (e web Dynpro component 


web Dynpro Component Interface 


Window Mame W CLASS RESULT | 
[rs — 
IÉ Ai 


4-21 
编辑 Web Dynpro 组 件 如 图 4-22 所 示 。 
Object Name - Description — 
~ di ZWD CLASS RESULT. | 班 同 成 员 查 询 结 果 


- zb COMPONENTCONTROLLER HEST pi? m erige E -—-:H PE TTE 
= di Component Interface 

- AÈ INTERFACECONTROLLER 
~ E Interface Views 


Pn eee pn METTE 


碍 明成 员 查 询 结果 ---- 视 图 


= [E windows 


s F] w CLASS RESULT ETT. 查询 结果 ---- 窗 杜 


4-22 
2) 在 ABAP 工作 台中 的 视图 编辑 界面 编辑 视图 。 
选择 视图 VY MAIN， 选 择 “Context” 选 项 卡 ， 编 辑 Context 如 图 4-23 所 示 。 


View V MAIN Inactive(revised) 


Outbound Plugs 4 Context 


Properties Inbound Plugs Attributes V Actions V Methods 


Context V. MAIN Fr —s —— 
dS. EIER Context COMPONENTCONTROLLER 
了 Loy 


* (Ü CONTEXT 


* B ZZNUMBER 
* "i ZzNAME 

* "i ZZSEX 

* "3 ZZFNAME 
* B ZZMNAME 
* "3 ZZMOBILE 
* "i ZZADDR 

* B ZZNOTE 
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Context 节点 NODE CLASS 设 定 如 图 4-24 所 示 


了 0 


[c Change Node 


Node Mame 


Interface Node 


Input Element (Ext.) 


Dictionary structure 


Cardinality 
Selection 


Init. Lead Selection 


Singleton 


Supply Function 


Mapping Path 


[NODE NUMBERS 


ZMNUMBER T 


| D..n v 


0..1 - 


v 


v 
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选择 “Layout” 选 项 卡 ， 插 入 UI 元 素 如 图 4-25 所 示 。 


* C] CONTEXT. MENUS 
~ [ ] ROOTUIELEMENTCONTAINER 


~ ^] TRY. NUMBERS 


* T CAPTION [Header] 


x. 


* T CAPTIO 


N 1 [Header] 


~ [H TBL, NUMBERS, ZZNUMBER 


* T TBL NUMBERS ZZNUMBER, HEADER 
* [`] TBL, NUMBERS. ZZNUMBER, EDITOR 


~ [E TBL. NUMBERS ZZNAME 


* T TBL NUMBERS ZZNAME HEADER 
* [`] TBL, NUMBERS. ZZNAME. EDITOR 


v [H TBL NUMBERS ZZSEX 


* T TBL NUMBERS ZzSEX HEADER 
* E TBL NUMBERS ZZSEX EDITOR 


~ [H TBL, NUMBERS. ZZFNAME 


* T TBL NUMBERS zzFNAME HEADER 
* E] TBL, NUMBERS ZZFNAME EDITOR 


~ [H TBL, NUMBERS ZZMNAME 


* T TBL NUMBERS ZzMNAME HEADER 
* [`] TBL, NUMBERS ZZMNAME EDITOR 


~ [H TBL NUMBERS ZZMOBILE 


* T TBL NUMBERS ZZMOBILE HEADER 
* [`] TBL, NUMBERS. ZZMOBILE EDITOR 


~ [E TBL. NUMBERS ZZADDR 


* T TEL NUMBERS ZZADDR HEADER 
-* [E] TEL, NUMBERS. ZZADDR EDITOR 


~ [M] TEL. NUMBERS ZZNOTE 


* T TBL NUMBERS ZzNOTE HEADER 
* E] TBL, NUMBERS. ZZNOTE. EDITOR 


编辑 布局 如 图 4-26 所 示 


班级 成 员 列表 
FEES 


V. MAIN.NODE_NUMBERS 
Y MAIN.NODE NUMBERS 
V. MAIN.NODE NUMBERS 


V MAIN.NODE NUMBERS 


V MAIN.NODE NUMBERS 


ZZNUMBER 
ZZNUMBER 
.LZNUMBER 


ZZNUMBER 


El aL CIEL [=] 


NUMBER 


姓名 


V. MAIN.NODE, NUMBERS.ZZNAME |... 
V. MAIN.NODE. NUMBERS 
V. MAIN.NODE. NUMBERS. 
V. MAIN.NODE, NLIMBERS 
V. MAIN.NODE. NUMBERS.ZZNAME | .. 


性 别 XE 


. | V MAIN.NODE NUMBER 
. | V MAIN.NODE. NUMBERS 
. | V MAIN.NODE. NUMBERS 


w V MÁIN.NODE NUMBERS 


wv MÁIN.NODE NUMBERS 
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母亲 
.ZZFNAME 
S.ZZFNAME 


ZZFNAME 


ZFNAME 
ZZFNAME 
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IN.NODE NUMBERS 


V. MA 
V. MAIN.NODE. NUMBERS 
V. MAIN.NODE, NUMBERS 
V. MA 


‘IN .NODE_NUMBER 


V. MÀ 


JN.NODE NUMBERS 


ZZMNAME 
ZZMNAME 


ZZMNAME 
NAME 
ZZMNAME 


联系 电话 


V MAIN.NODE NUMBERS. 


V. MAIN.NODE. NUMBERS.Z 


V. MAIN.NODE, NUMBERS. 
V. MAIN.NODE. NUMBERS. 
V. MAIN.NODE, NLIMBERS 


ZZMOBILE 


ZZMOBILE 


ZZMOBILE 


家 庭 住址 


Y MAIN.NODE_NUMBERS.ZZADDR 


V. MAIN.NODE. NUMBERS 
V. MAIN.NODE. NUMBERS 
V. MAIN.NODE, NUMBERS 
V. MAIN.NODE, NLIMBERS.ZZADDR 
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UI 元 素 TBL NUMBERS 绑 定 属性 设 定 如 图 4-27 所 示 。 


[Er Create Context Binding for Table "TEL, NUMBERS" 


Context Nade "Y MAIN. NODE NUMBERS 
Standard Cell Editor Text View - 
Standard Property text = 


Context Attribute Cell Editor af Table column Binding Mame af Property to Be Bound 


ZFNUMBER TextView El text z 
LIE Textvieu B| [v] text = 
Sess DroapDownBykey ËI A selectedkewy ËI 
ZEFNANE TextVview il [v] text El 
zZEMNAME TextVview il [v text El 
zz MOBILE Textview El [v text El 
Ze DDR. TextView El [v] text El 
ZMOTE TextVview il I" text El 


图 4-27 


选中 “Actions” 选 项 卡 ， 创 建 动 作 如 图 4-28 所 示 。 


View V MAIN Active 
Properties * Inbound Plugs Outbound Plugs Context V Attributes . Actions Methods - 

区 区 回回 

| Action Action Type Description Event Handler 
Ë 


T è Standard Y 接受 门户 所 传递 参数 


standard 了 


ONACTIONRECIEVE NUMBERS 


图 4-28 
编辑 动作 处 理 程序 如 下 : 


METHOD ONACTIONRECIEVE NUMBERS. 
* Portal 事件 操作 变量 
DATA: EVT NAME TYPE STRING, 
LV PARAMETER TYPE STRING. 
* Context 赋值 操作 变量 
DATA LO ND NODE NUMBERS TYPE REF TO IF WD CONTEXT NODE. 


DATA LT NODE NUMBERS TYPE WD THIS--ELEMENTS NODE NUMBERS. 
* 取得 Portal 事件 
EVT NAME = WDEVENT--GET STRING( NAME - PORTAL EVENT NAME). 
IF EVT NAME = 'showClassNumber'. 
LV PARAMETER-WDEVENT--GET STRING(NAME-'PORTAL EVENT PARAMETER" ). 


了 6 


* navigate from «CONTEXT» to «NODE NUMBERS- via lead selection 
LO ND NODE NUMBERS = WD CONTEXT->GET CHILD NODE( NAME = WD THIS-- 
WDCTX NODE NUMBERS ). 
* (QIODO handle non existant child 
* JF lo nd node numbers IS INITIAL. 
* ENDIF. 


(TODO compute values 
SELECT B-ZZNUMBER 
B-ZZNAME 
B-ZZSEX 
B-ZZFNAME 
B-ZZMNAME 
B-ZZMOBILE 
B-ZZADDR 
B-ZZNOTE 
FROM ZTTEST TAS A 
INNER JOIN ZMNUMBER T AS B 
ON | A-ZZSTDNO = B-ZZNUMBER 
INTO CORRESPONDING FIELDS OF TABLE LT NODE NUMBERS 
WHERE ZZCLASS = LV PARAMETER-40(2) 
AND ZZYEAR = LV PARAMETER+2(4) 


* 赋值 
LO ND NODE NUMBERS->BIND TABLE( NEW ITEMS - LT NODE NUMBERS SET IN 
ITIAL ELEMENTS = ABAP TRUE ). 


ENDIF. 
ENDMETHOD. 


转 到 Methods 标签 页 ， 编 辑 钩子 方法 WDDOINIT 如 下 : 


METHOD WDDOINIT . 
* Portal 事件 注册 变量 
DATA:L API COMPONENT TYPE REF TO IF WD COMPONENT, 
L PORTAL MANAGER TYPE REF TO IF WD PORTAL INTEGRATION, 
VIEW TYPE REF TOIF WD VIEW CONTROLLER. 
L API COMPONENT = WD COMP CONTROLLER--WD GET API(). 
L PORTAL MANAGER =L API COMPONENT--GET PORTAL MANAGER( ). 
VIEW ?= WD THIS->WD GET API(). 


* 注册 事件 
L PORTAL MANAGER->SUBSCRIBE EVENT( 
PORTAL EVENT NAMESPACE = 'urn:com.sap.webdynpro.portalintergration.showClassNumber' 
PORTAL EVENT NAME - 'showClassNumber' 
VIEW = VIEW 
ACTION - RECIEVE NUMBERS! ). 
ENDMETHOD. 
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3) 在 ABAP 工作 台中 的 Web Dynpro Application 编辑 界面 创建 Web Dynpro Application, 
如 图 4-29 所 示 。 


[c Create Web Dynpro application 


Application zwd. class. result 


ue" Ir 本 
Description 班级 成 员 查 询 结果 
一 zl 


图 4-29 


4.4.2 ”创建 iView 及 页 面 


(1) 为 查询 应 用 程序 创建 iView 
1) 按照 路 径 (http://xitst:50000/itj〉 登 录 门 户 系统 。 
转 到 内 容 管理 页 面 ， 如 图 4-30 所 示 。 


门户 内 容 
ria AUD -——H— — — | 
| BIZ Es mi 
f) 无 要 显示 的 项 目 » LI Business Objects = 
CI Netweaver 内 容 生产 者 


= 站 门户 内 容 alil e E | 
b CJ com.sap.ip.collaboration "m Jia ^ "n n 77] j | | 
y 734028033 fj = 


"i im 


"C UE 
ES 成 绩 查 询 | m 

b CJ specialist !: 

CJ Systemlandscape K 

y Test 
y Test 

[ themes 

L unification 5.0 门户 内 容 工 作 室 提供 开发 和 管理 门户 内 容 的 中 心 | 图 标 图 例 
p L Visual Composer 环境 : view, ME, 格式 ,工作 集 , 角色 和 数据 包 . 接口 结构 
六 一 桓 析 站 主要 概念 

l —— 提示 
图 4-30 


EHW F, H meri tE r “Context” ARA CO”, RR 4-31 所 示 的 路 
径 局 动 i View 问 导 。 


图 4-31 


20 在 应 用 技术 (Application Technology) 问 导 页 中 ， 选 择 Web Dynpro ABAP 应 用 程序 ， 
创建 一 个 Web Dynpro ABAP 应 用 程序 的 1View， 如 图 4-32 所 示 。 
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源 类 型 页面 创建 ”综述 
基于 以 下 之 一 的 新 视图 : 


全 视图 模板 一 根据 现 有 视图 模板 来 创建 视图 
个 门户 组 件 一 创建 包含 在 部 署 门户 归档 (PAR ) 交 件 中 的 门户 组 件 的 视图 
C Web Dynpro 应 用 程序 一 ”根据 部 署 Web Dynpro 应 用 程序 创建 视图 


[Wi | Da 
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P: 模板 选择 
CKM 讨论 组 提供 者 view 
CKM 讨 伦 组 管理 iview 
CKM ACE iview 
个 KM 高 速 缓存 些 视 器 view 
CSAP BSP iView 
CSAP IAC iView 
CSAP Mini&pp iview 
CSAP RFC iView 


Qe 


CSAP 事务 iView 

(CURL iView 

CwWeb 服务 iview 

(CXML iView 

CASES] Portlet iview CAWSRP) 

个 协作 配置 模板 

个 工作 和 集 映射 iview 

个 服务 映射 ivieww E 


4-33 
选中 “SAP Web Dynpro iView" Fikih, "ult 


T3. 常规 属性 
iview 名 称 : * 


才 级 成 员 坦 1 


iview 标识 : * 
iview 标识 前 妊 (例如: com. 公 司 和 名称 


|] [到 | — 5 E 
图 4-34 


HUGUES EN, Sñ HUD 
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pi kn Web Dynpro Platform 
Select whether you want to create a Web Dynpro for Java or Web Dynpro for ABAP iView 


Platform: * 


(eb Dynpro for Java 


RH) [SERT] [到 [完成] 
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选中 “Web Dynpro for ABAP” 单 选 按钮 ， 单 击 


Wi: Web Dynpro Parameters 
Enter the parameters of the Web Dynpro application for which you want to create the view 
System: * [4] 


[sa NsP y] 


Namespace: * 


Application Name: * 


zwd class Search| IU assasi 


Web Dynpro Client: 
(«Plain HTML 
CuWindowes Client 
(Java Client 


Configuration Name: 


LL | 


Application Parameters: 回 | 


DR] EE - — — [==] 
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TH 按钮 ， 如 图 4-37 所 示 。 


^S 


EZ un Hz 
iView 名 称 : 班 绷 成 员 查询 画面 
iview 标识 :: Class_Search 
主语 言 :: m 
System: SAP NSP 


wWebDynproMamespace: sap 
WebDynproApplication: —zwed class search 
ClientType:: HTML 
DefinitionType:: ABAP 


口 当 向 导 完 成 时 将 其 打开 进行 编辑 


WA) DERI] [下 -个 >] [ERERE] 


4-37 
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确认 信息 无 误 ， 单 击 蕊 可 按钮 。 

(2) 为 但 询 结 果 应 用 程序 创建 iView 

D ÆW F, H merat "Context" semi "Cus", 
按照 向 4-38 所 示 的 路 径 司 动 View [n] S, 

20 在 应 用 技术 (Application Technology) 问 导 页 中 ， 选 择 Web Dynpro 
ABAP 应 用 程序 ， 创 建 一 个 Web Dynpro ABAP 应 用 程序 的 1View， 如 图 4-39 
所 示 。 


iView Fi 5e 


AXE mmie St 
基于 以 下 之 一 的 新 视图 : 
含 视 图 模板 一 根据 现 有 视图 模板 来 创建 视图 


C[]PiBft 一 创建 包含 在 部 署 门户 归档 ( PAR ) 净 件 中 的 门户 组 件 的 视图 
(web Dynpro 应 用 程序 一 ”根据 部 署 Web Dynpro 应 用 程序 创建 视图 


图 4-39 


按钮 ， 如 图 4-40 Br. 


iView Fi tr 


步 又 1: 模板 选择 

CKM 讨论 组 提供 者 iview n 
CKM 讨 伦 组 管理 iView 

CKM 配置 jiwiew 

CKM 高 速 妈 存 监 视 器 view 

CSAP BSP iView 

CSAP IAC iView 

CSAP Mini&pp iview 

CSAP RFC iView 


CSAP 事务 iView 

CURL iVievv 

Cuveb IRS iview 

(CXML iView 

CASES] Portlet iview (VVSRP) 

个 协作 配置 模板 

个 工作 集 映射 ivieww 

个 服务 映射 iieww [<] 


图 4-40 


选中 “SAP Web Dynpro iView” 单 选 按钮 ， 单 击 [下 二 个 国 按 钮 ， 如 网 4-41 所 示 。 
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LLL LLL LL C í í í í í í í í í í í í í í í í 

pi f 常规 属性 

iview 名 称 : * 四 
于 级 成 结果 


iview 标识 : * 


Class Namber MNRPREMNESENERERENORNMME 


iview 标识 前 如 (例如 : com .公司 名 称 ) 


mE EE es 
图 4-41 


填写 必要 信息 ， 单 击 [ iath "lll 4-42 所 示 。 


pi Kn Web Dynpro Platform 
Select whether you want to create a Web Dynpro for Java or Web Dynpro for ABAP iView 


Platform: a 
i(*Areb Dynpro for ABAP 
CwWeb Dynpro for Java 


RH) E - — MESI 
图 4-42 


选中 “Web Dynpro forABAP” 单 选 按钮 ， 单 击 [下 


Wd: Web Dynpro Parameters 


Enter the parameters of the Web Dynpro application for which you want to create the iview 
System: * [4] 


[sap NsP 了 | 


Namespace: * 


Application Name: * 


zw class resul| e 


Web Dynpro Client: 
(«Plain HTML 
CwWindows Client 
(Java Client 


Configuration Name: 


Application Parameters: [z] 


[Wo] DERI] ES E 
图 4-43 


按钮 ， 如 图 4-44 所 示 。 


WEARS, MHT 


New iview 
iView 向 导 
pa ur 简要 
iview AER: 班组 成 员 查 询 结 果 固 面 
iview 标识 :: Class_Number 
主语 言 :: i 
System: SAP NMSP 


WWebDynproMamespace: sap 
WebDynproApplication:: zwed class result 


ClientType:: HTML 
DefinitionType:: ABAP 
器 当 向 导 完 成 时 将 其 打开 进行 编辑 


图 4-44 


确认 信息 无 误 ， 单 击 医 列 按钮 。 
(3) 为 创建 iView 创建 页 面 


1) 在 当前 文件 夹 下 , H Ugo BE Sa iH " Context" 3E 8p p “C gan”, 


按照 图 4-45. 所 示 的 路 径 司 动 页 面 问 导 。 


创建 框 絮 为 两 列 的 页 面 ， 页 面 属性 设置 如 网 4-46 所 示 。 


AAN IH) 


Page Fi 5r 


3 G 


4 


页 面 EE ”页 面 模板 Unus 06 
此 向 导 指 引用 户 通过 必要 的 步骤 ,基于 现 有 模板 创建 门户 页 面 


呈 定 新 对 象 的 通用 尾 性 
页 面 名 称 : * 
| 班级 成 员 | 
页 面 标识 :* 
[Class — sl 
页 面 Tagus C np: com.companyname ) : 
| 
FES * 
pir [| 
描述 : 


Ah Fi 图 按 钮 ， 如 图 4-47 所 示 。 
选中 “Web pyrpro 代理 页 ” 单 选 按钮 ， 单 击 [ 于 二 下 


2) 在 应 用 技术 (Application Technology) 向 导 页 中 ,填写 必要 信息 ， 


如 图 4-48 所 示 。 
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选择 布局 2 列 〈 同 一 宽度 )， 单 击 [ 


页 面 Et 。 页 面 简 板 mnm o c 


选择 新 页 面 基于 的 页 面 模板 。 
模板 清单 皮 映 缓存 的 内 容 ; 用 户 可 能 需要 刷新 清单 来 获 职 最 新 的 模板 。 


L1 

选择 模板 : 

(ç wWeb Dynpro 代理 页 
个 氧 省 页 面 模板 
eruat 


DR] ESI MES 


4-47 


页 面 BE ë MERE 页面 布局 综述 
选择 新 页 面 的 布局 。 分 配 多 个 布局 使 用 户 在 运行 时 具有 更 多 个 性 化 选项 。 


选择 的 布局 : * 


列 [同一 宽度 ) 
41 列 (完整 宽度 ) | 
2 列 CE) Em 
3 列 ERF) pe 
1T- 布 局 ( 顶部 - 全 宽 ; 底部 - 2 等 宽 ) | 
T- 布 局 ( 顶部 -全 宽 ; LEE 
TRAORE - 全 宽 ; ES P 
TEC 
GP TAR OTR - 全 部 宽度 ; 底部 CE : 宽 


[WWE] ME [T—T B] [5655] 
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页 面 mno 页面 模板 页面 布局 FE 


选择 新 页 面 的 布局 。 分 配 多 个 布局 使 用 尸 在 运行 时 具有 更 多 个 性 化 选项 。 


可 用 布局 选择 的 布局 ° 
TT RRRS - 全 宽 ; 中 间 -2 个 等 宽 ) [4] 2 列 (同一 宽度 ) — 


T- 布 局 ( 顶部 - 全 宽 ; 底部 - 2 等 宽 ) 


T- 布 局 ( 顶部 - 全 宽 ; 底部 GEI 

T- 布 局 ( 顶部 - 全 宽 ; 底部 -AE 

2 列 (R£) 

GPT- 格 式 ( 顶端 - 全 部 宽度 ; 底部 EAD [>] 


默认 布局 :* 
2 列 (同一 宽度 ) g 


DR0] E [T—T B] [7:3] 
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按钮 ， 为 页 面 选择 iView 的 布局 ， 如 图 4-49 所 示 。 


AFHZ, "n 4-50 所 示 。 


2 


mum 属性 页面 模板 页面 布局 SE 
将 在 立 件 来 中 创建 以 下 内 容 : portal content/NSP 
HE 细节 


班级 页面 ID: Class 
成 员 页面 Name: ERN 


Web Dynpro 代理 页 
可 用 布局 251 (同一 宽度 ) 
默认 布局 2 列 (同一 宽度 ) 


Cn 
图 4-50 

Mie kl ui, BA Be]. 

3) 编辑 页 面 属性 。 

页 面 编辑 完成 后 ， 单 击 画 辐 按 钮 ， 编 辑 页 面 Page， 如 图 4-51 所 示 。 


选择 下 一 步 : 
(€ 打开 用 于 编辑 的 对 


Ed 
C BW B shieli = , LLEBFRHERIRIESHRE CENAR 
号 关闭 向 导 
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在 当前 文件 夹 下 ， 选中 iView 国 HITRA 2=ismim AE Meema, JH bo BER S 
"Context" KA, JAHR 4-52 所 示 的 路 径 将 iView 添加 到 页 面 。 


SRI iviewe SRA & WEHE 
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页 面 属性 设 定 如 图 4-53 所 示 。 
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BEEN pb m 


刷新 显示 : [对 象 -] 
mme CHEETA » 尾 性 编辑 器 - 班级 成 员 
“ahi 目录 中 选择 您 想 添加 到 该 页 的 内 容 。 在 尾 性 编辑 器 中 ， 编辑 访 页 ， 访 页 的 iview 及 页 面 的 尾 性 尾 性 类 别 |: | 外观 -大 小 "| 
HEAR Cs) 
B AHI 名 称 $ mR s mas Bess "7 C 
[]| [p | 班级 成 员 查询 画面 | Class, Search n ， 最 大 自动 高 度 ( 象 素 ) 
[l pm] | 班级 成 员 查 询 结果 画面 Class Number [] ， 最 小 自动 高 度 ( 象 素 ) [0 | 
» OQ 高 度 类 型 [FULL PAGE "| 
目 日 日 日 | Wan 
[EFFE] TTE H] BE] 显示 班级 成 员 ' 属性 
4-53 


选择 各 个 iView, HRUEENETI, ARAINA View 内 容 ， 将 其 高 度 类 型 设 为 
|auTowaTc 避 ， 并 单 击 “保存 ”按钮 ， 如 图 4-54 所 示 。 


BEER pt; m 


ERA) [2A] [FE 
C 页 面 内 容 CHEER 


[EH] RER] gx [MR 本 


> 尾 性 篇 辑 器 - 班级 成 员 
本 也 可 以 添加 更 多 格式 ， 移 除 格式 ， 以 及 定义 各 ”属性 类 别 : [装载 >| 


— y, 允许 客户 六 进行 女 存 No Y 
显示 格式 : [2 列 (同一 宽度 ) 818 v | EXER. ida | z] 
Colurnn 1 Colurnn 2 工作 分 配 主题 L | 
Ld e EU | Mone Y | 
w vi mm 
国 班 级 成 员 查 询 回 面 同班 级 成 员 查询 结果 男 面 MEX JE EE š 


4-54 
编辑 结果 如 图 4-55 所 示 。 
aean, MN 
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内 容 管理 
门户 内 容 | SREE | IPSE | web Dynpro | 活动 报表 | KM 内容 | 协作 内 容 | 工作 流 内 容 
门户 内 容 


Ups === 
13:58:38 - Jy THER 
| — = m 对 象 已 成 功 册 除 


m) 无 要 显示 的 项 目 ER 


EI EOS 


» CJ Business Objects <^ 
C Netweaver 内 容 生产 者 
门 门户 内 容 
b [3] com.sap.ip.collaboration 
» 34028033 
vONsP 
E 成 绩 查 询 
班级 成 员 
E 班级 成 员 查 询 男 面 
E 班级 成 员 查 询 结果 画面 
C3 specialist 
C3 Systemlandscape 


y Ore 


"m Uu M 


wa p voll ag hin ^r | ze "e T ru 
" "n I: " III ^u E ei P IT 


门户 内 容 工作 室 提供 开发 和 管理 门户 内 容 的 中 心 
Mae f! 环境 : iview, 页 面 , 格式 , LER, 角色 和 数据 包 . 
, 


图 标 图 例 
接口 结构 
;主要 概 全 
提示 
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4) 测试 页 面 上 事件 啊 应 。 
测试 结果 如 图 4-56 所 示 。 
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文件 @) REO SEV 收藏 IAW SEO 5 0 E 4 
QRmB-oO-iizo|osS-x wx Ol A BA 


地 址 Q) £) http;/fzitst.sap.com:500007/irj/servlet/prt/portalfprtroot/pcd!3aportal_content!2£NSP!2fClass?sap- 


| 班级 成 员 查 询 画 面 lul 班级 成 员 查 询 结果 画面 
DII. (WHERE 
YER: FAE Tel | ESS 姓名 ”性别 RE ”和 母亲 ”联系 电话 REE 
学 年 : [2009 [8 || 000: 郑 喜 定 女性 郑 义 ERR 12384765678 北京 鲁迅 路 126; 


00002 MEX ”男性 HRE WA — 13987645679 北京 鲁迅 路 129; 
00003 £x xt g HIE — 13987645677 ”北京 鲁迅 路 130; 
00004 EB ”男性 HES ROS 13987645680 北京 鲁迅 路 131; 
00005 te | 男性 HEA SEHE 13987645681 JbA EUREE 32 


———————————————————————————————————————————————————————— 


E 完毕 | | | | | - Internet Z 


图 4-56 


45 ”门户 导航 (Portal Navigation) 


SAP 企业 门户 网 站 文 持 各 关门 户 内容 之 间 的 导航 。 例 如 , 一 个 Web Dynpro 应 用 程序 可 以 
浏览 门户 网 站 的 内 容 以 及 其 他 不 同 的 Web Dynpro 应 用 程序 。 门 户 网 站 的 内 容 可 以 是 一 个 BSP 
或 ITS 中 的 应 用 。 

页 和 面 导航 是 基于 对 象 的 ， 可 以 是 绝对 的 或 相对 的 。 


4.51 ”基于 对 象 的 导航 (OBN) 


SAP 企业 门户 内 容 的 结构 是 基于 角色 的 。 用 户 可 以 采用 顶级 导航 和 详细 的 导航 浏览 特定 用 户 
的 导航 结构 。 门 户 网 站 的 导航 可 以 把 不 同 的 iView 或 页 面 (Page) 作为 一 个 门户 网 站 的 内 容 并 在 
它们 之 间 进 行 导航 。 

在 许多 情况 下 ， 需 要 充分 使 用 相对 导航 或 绝对 导航 ， 导 航 到 一 个 特定 的 iView 或 页 面 。 
特别 地 ， 有 时 需要 更 多 灵活 性 。 为 了 这 个 目的 ， 程 序 员 可 以 使 用 基于 对 象 的 导航 。 它 允许 程 
序 员 在 一 个 更 高 的 层次 《业务 对 象 ) 定义 导航 步骤 。 不 是 定义 一 个 具体 的 URL. 目标 ， 而 是 调 
用 一 个 特定 业务 对 象 的 特定 操作 。 

在 门户 中 可 以 配置 具体 的 View (或 页 面 ) 用 于 执行 此 操作 。 这 种 配置 可 以 是 特定 的 角色 
或 特定 的 用 户 。Web Dynpro 应 用 程序 本 身 传递 业务 对 象 的 名 称 和 链接 到 它 的 操作 。 

在 Web Dynpro ABAP 中 ,基于 对 象 的 导航 集成 是 非常 类 似 门户 网 站 事件 的 集成 。 为 了 触 
REAK, Web Dynpro Framework 提供 了 一 个 服务 。 该 服务 可 以 从 应 用 程序 调用 ， 像 门户 
网 站 事件 ， 是 门户 管理 的 一 部 分 。 

1. 触发 基于 对 象 的 导航 

可 以 在 Web Dynpro ABAP 的 门户 网 站 中 调用 接口 正 WD PORTAL INTEGRATION 的 方 
法 NAVIGATE TO_OBJECT， 激 活 基 于 对 象 的 导航 。 程 序 员 可 以 使 用 Web Dynpro 中 的 代码 
问 导 目 动 生成 以 下 代码 : 
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DATA LR COMPONENTCONTROLLER TYPE REF TO IG COMPONENTCONTROLLER . 
DATA L API COMPONENTCONTROLLER TYPE REF TO IF WD COMPONENT. 
DATA LR PORT MANAGER TYPE REF TO IF WD PORTAL INTEGRATION. 
LR COMPONENTCONTROLLER = WD THIS--GET COMPONENTCONTROLLER CTR(). 
L API COMPONENTCONTROLLER = LR COMPONENTCONTROLLER- WD GET API(). 
LR PORT MANAGER-L API COMPONENTCONTROLLER-GET PORTAL MANAGER( ). 
CALL METHOD LR PORT MANAGER-NAVIGATE TO OBJECT 

EXPORTING 


SYSTEM = NAVIGATION DATA-SYSTEM 

OBJECT TYPE = NAVIGATION DATA-OBJECT 

OPERATION = NAVIGATION DATA-OPERATION 

OBJECT VALUE NAME -NAVIGATION DATA-OBJECT VALUE NAME 

OBJECT VALUE = NAVIGATION DATA-OBJECT VALUE 

BUSINESS PARAMETERS = BUS PARAMETER LIST 

FORWARD OBN METADATA - NAVIGATION DATA-FORWARD OBN METADATA. 


(1) 对 于 导航 只 有 以 下 两 个 参数 是 必需 的 

1) SYSTEM: 指定 业务 对 象 被 分 配 到 的 系统 (或 系统 别名 )。 

2) OBJECT TYPE: 指定 使 用 的 业务 对 象 。 

(2) 所 有 其 他 参数 都 是 可 选 的 

1) OBJECT VALUE。 通 常 有 许多 不 同 的 业务 对 象 实例 ， 如 对 于 业务 对 象 客户 。 可 以 使 
用 参数 指定 特定 客户 〈 如 使 用 客户 编号 ) 调用 基于 对 象 的 导航 步骤 。 

2) OPERATION: 可 以 使 用 该 参数 指定 基于 对 象 的 导航 步骤 的 操作 。 

3) OBEJCT VALUE NAME: 指定 对 象 的 值 传送 一 个 URL 参数 到 OBN 步骤 。 该 参数 的 
标准 名 称 是 ObjectValue。 程 序 员 也 可 以 更 改 该 名 称 。 

4) BUSINESS PARAMETERS: 除了 指定 对 象 的 值 ， 可 以 定义 由 OBN 步骤 转发 的 其 他 
人 参数。 可 以 定义 一 个 参数 字符 串 ， 如 Mode=Edit&ShowHeader=false。 在 业务 对 象 的 操作 做 好 
相应 准备 的 前 担 下， 这 些 参数 可 以 被 目标 OBN 使 用 。 

5) FORWARD OBN_METADATITA。 有 了 时， 从 当前 的 导航 步骤 中 接收 更 多 的 详细 信息 
对 于 OBN 目标 是 有 益 的 。 举 例 来 说 ， 如 果 程 序 员 实现 一 个 应 用 程序 ， 用 于 实施 某 一 业务 
对 象 上 执行 的 不 同 操作 ， 则 应 用 程序 必须 知道 所 引发 OBN 步骤 的 操作 。 因 此 ， 可 以 通过 
以 下 参数 : 

€ obn.system: 业务 对 和 象 所 分 配 到 的 系统 。 

€ obn.bo type: 业务 对 象 本 刁 

€ obn.operation: 当前 操作 ， 该 值 是 “ default ". 

(3) 在 门户 中 维护 目标 应 用 

目标 应 用 程序 保存 在 门户 网 站 中 的 业务 对 象 的 相应 的 操作 中 ， 这 通常 由 门户 省 理 员 
维护 。 

对 于 一 个 WDA 目标 应 用 程序 的 业务 参数 ， 使 用 Web Dynpro ABAP 应 用 程序 定义 的 
参数 时 ， 如 果 动 态 地 分 配 应 用 程序 参数 给 启动 插头 ， 则 可 以 在 应 用 程序 中 的 文档 中 找到 
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为 了 使 Web Dynpro ABAP 应 用 到 目标 应 用 程序 乙 间 能 够 正确 传输 业务 参数 ， 下 面 的 
JavaScript 代码 必须 被 保存 在 目标 应 用 程序 的 基于 对 象 导航 内 : 


return 'DynamicParameter-' + obj Value; 


2. 基于 角色 的 权限 检查 

因此 ， 导 航 的 执行 依赖 于 在 门户 中 自 定 义 角 色 的 设置 。 例 如 ， 一 个 角色 的 用 户 可 以 具有 
用 于 显示 和 编辑 页 面 内 容 的 授权 ， 而 用 户 可 能 只 被 允许 的 另 一 个 作用 是 要 显示 门户 内 容 。 如 
果 用 户 要 触发 基于 对 象 的 导航 ， 但 该 角色 不 具有 相应 操作 的 授权 ， 则 相应 的 错误 消息 会 被 显 
示 出 来 。 为 了 尽 可 能 地 提供 友好 的 用 户 界 面 ， 从 一 开始 就 不 提供 会 出 现 此 问题 的 用 户 操 作 。 
然而 ， 为 了 这 个 目的 ， 必 须 由 门户 得 到 相应 操作 的 授权 信息 。 这 可 以 通过 Web Dynpro ABAP 
系统 中 的 类 CL WDR PORTAL OBNWEB SERVICE 调用 Web 服务 来 取得 。 


4.5.2 ”绝对 地 址 导航 


可 以 在 Web Dynpro ABAP 系统 所 在 的 门户 中 使 用 门户 管理 器 (接口 IF_WD_PORTAL ` 
INTEGRATION 的 方法 NAVIGATE ABSOLUTE) 激活 绝对 地 址 导航 。 程 序 员 可 以 使 用 代码 
器 性 生成 一 个 模板 以 便 编辑 上 其 体 应 用 。 

使 用 绝对 导航 工具 ， 必 须知 道 要 显示 的 页 面 名 称 ， 以 便 把 该 名 称 传 到 方法 中 。 


DATA LR COMPONENTCONTROLLER TYPE REF TO IG COMPONENTCONTROLLER . 
DATA L API COMPONENTCONTROLLER TYPE REF TO IF WD COMPONENT. 
DATA LR PORT MANAGER TYPE REF TO IF WD PORTAL INTEGRATION. 
LR COMPONENTCONTROLLER = WD THIS--GET COMPONENTCONTROLLER CTR( ). 
L API COMPONENTCONTROLLER = LR COMPONENTCONTROLLER-;WD GET API(). 
LR PORT MANAGER-L API COMPONENTCONTROLLER-»GET PORTAL MANAGER( ). 
CALL METHOD LR PORT MANAGER-NAVIGATE ABSOLUTE 
EXPORTING 

NAVIGATION TARGET - NAVIGATION DATA-TARGET 

NAVIGATION MODE -NAVIGATION DATA-NAVIGATION MODE 

WINDOW FEATURES -NAVIGATION DATA-WINDOW FEATURES 

WINDOW NAME . -NAVIGATION DATA-WINDOW NAME 

HISTORY MODE . -NAVIGATION DATA-HISTORY MODE 

TARGET TITLE —. - NAVIGATION DATA-TARGET TITLE 

CONTEXT URL — - NAVIGATION DATA-CONTEXT URL 

POST PARAMETERS = ABAP FALSE 

USE SAP LAUNCHER = ABAP TRUE 

BUSINESS PARAMETERS - BUS PARAMETER LIST 

LAUNCHER PARAMETERS = LAUNCHER PARAMETER LIST. 


导航 目标 是 这 里 的 唯一 必 选 参数 。 它 代表 了 在 门户 网 站 中 的 绝对 地 址 。 其 他 参数 被 用 于 
控制 导航 ， 是 可 选 的 。 可 以 在 门户 中 的 各 个 应 用 程序 启动 器 中 设置 业务 参数 和 参数 。 为 了 业 
务 参 数 能 正确 传递 到 目标 应 用 程序 ， 必 须 设 置 参 数 USE SAP LAUNCHER。 如 果 它 是 一 个 
SAP 应 用 程序 (如 BSP 或 Web Dynpro 等 )， 则 必须 将 其 值 设 置 为 TRUE， 见 表 4-3。 
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Ww 


数 


NAVIGATION TARGET 


NAVIGATION MODE 


WINDOW FEATURES 


WINDOW NAME 


HISTORY MODE 


TARGET TITLE 


CONTEXT URL 


POST PARAMETERS 


USE SAP LAUNCHER 


BUSINESS PARAMETERS 


LAUNCHER PARAMETERS 
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地 址 
li] ROLES://portal content/ 


e. 


J 


J 


DIRECTORIES 显示 浏览 器 中 Directory 按钮 
WIDTH 


web dynpro abap/ 
web dynpro abap tester/ 
portal integration/ 


portalNavigation/ 


portal navigation target 
act 
在 新 的 页 面 显 示 导 航 ， 但 只 是 
作为 目标 的 iView 
在 新 的 门户 页 面 显示 导航 目标 
示 浏 览 器 i 


STATUS 显示 状态 栏 


SCROLLBARS 显示 滚动 条 


ALLOW DUPLICATIONS 可 以 列 出 一 次 以 上 的 导航 历史 


只 能 列 出 一 次 导航 历史 


NO HISTORY 没有 历史 导航 条 目 


NO DUPLICATIONS 


字符 串 
字符 串 
TRUE 作为 一 个 POST 请 求 传送 参数 


FALSE (默认 值 ) 作为 一 个 GET 请 求 的 传输 参数 
TRUE (默认 值 ) 目标 调用 使 用 SAP RITAS 如 BSP 
目标 调用 不 使 用 SAP 发 射 器 


WDR NAME VALUE LIST 


WDR NAME VALUE LIST 


描述 

绝对 地 址 、 页 面 或 
iView 在 门户 内 容 目 
录 的 路 径 。 该 路 径 将 
显示 在 门户 网 站 目 
Ko 例如 ， 当 编辑 一 
个 页 面 或 iView 的 
路 径 


叶 航 模式 


附加 的 JavaScript 
窗口 参数 。 例 如 ， 字 
符 集 或 尺寸 规格 ， 如 
宽度 = 300 高 度 = 250, 
这 些 参 数 是 由 逗号 分 


隅 。 不 允许 有 空格 


外 部 浏览 右 目 标 
页 面 的 标题 

指定 导航 历史 记 
录 中 是 否 列 出 访问 
过 的 网 页 地 址 


门户 页 面 的 标题 
指定 押 便 用 的 村 


Wi Context 


参数 传输 选项 


SAP JH ss 


H URL 传递 导航 到 
目标 应 用 程序 的 参数 

应 用 发 射 器 的 参 
数列 表 , 如 WebDynpro 


Namespace=myNam 


espace 


ME: 如 果 在 Web Dynpro 应 用 程序 中 定义 BUSINESS. PARAMETERS 为 应 用 程序 的 参数 ， 
并 且 参 数 的 名 称 以 “APP” 作 为 字 头 ， 则 它们 将 被 自动 转发 到 Web Dynpro 应 用 程序 的 启动 插 
头 被 标记 为 启动 参数 。 在 这 种 情况 下 ， 作 为 导航 目标 的 iView/ 页 面 必 须 被 分 配给 用 户 相应 角 
色 。 如 果 没 有 分 配 ， 则 时 航 可 能 不 被 触发 。 


4.53 ”相对 地 址 导航 


相对 地 址 导航 变 体 可 以 用 于 提供 跨 几 个 目录 内 容 显 示 。 在 门户 网 站 中 Web Dynpro ABAP JV 
用 要 激活 相对 地 址 导航 ， 使 用 接口 IF WD PORTAL INTEGRATION 的 方法 NAVIGATE ` 
RELATIVE。 使 用 代 人 码 同 导 可 以 生成 一 个 模板 ， 程 序 员 可 以 根据 具体 应 用 改变 相关 参数 。 


CALL METHOD LR PORT MANAGER->NAVIGATE RELATIVE 
EXPORTING 

BASE URL = NAVIGATION DATA-BASE URL 

LEVELS UP- LEVELS UP 

PATH= PATHLIST 

NAVIGATION MODE = NAVIGATION DATA-NAVIGATION MODE 
WINDOW FEATURES = NAVIGATION DATA-WINDOW FEATURES 


WINDOW NAME - NAVIGATION DATA-WINDOW NAME 
HISTORY MODE = NAVIGATION DATA-HISTORY MODE 
TARGET TITLE = NAVIGATION DATA-TARGET TITLE 
CONTEXT URL = NAVIGATION DATA-CONTEXT URL 

USE SAP LAUNCHER = ABAP TRUE 

BUSINESS PARAMETERS - BUS PARAMETER LIST 
LAUNCHER PARAMETERS = LAUNCHER PARAMETER LIST. 


相对 地 址 导航 可 以 使 用 自 定义 的 起 点 ， 具 体 参数 见 表 4-4. 


表 4-4 


BASE URL 路 径 名 相对 导航 的 起 点 
LEVELS UP m m 导航 结构 中 向 上 的 导航 步 台 


PATH L 路 径 名 目标 应 用 程序 的 相对 路 径 列 表 


示例 : 


BASE URL : pcd:rolel/folderl/folder2/fodler3/worksetl/pagel 
LEVELS UP: 3 


PATHLIST: folder4/workset2/page2 
目标 路 径 pcd:rolel/folderl/folder2/folder4/workset2/page2. 


参数 BASE URL 可 以 不 指定 ， 在 这 种 情况 下 ， 当 前 的 URL WEH. PATH 是 一 个 最 近 
的 节点 列表 。 在 这 种 情况 下 ，PATH 列表 中 的 值 将 是 : 
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folder4 
workset2 


page2 


4.5.4 Resume Plugs 和 门户 导航 


xT SLIME, EF à up bd — T AXE TESI TU XS (Resume plug)。 在 门 
户 导 航 时 ， 继 续 插 头 〈Resume plug) 的 作用 是 : 在 运行 的 应 用 程序 如 果 在 门户 导航 时 识别 这 
样 的 插头 ， 前 者 不 是 导航 时 退出 ， 而 是 被 转移 到 挂 起 模式 。 会 话 〈S$ession) ID 和 Context 内 
容 被 保留 下 来 ， 并 开始 一 个 新 的 应 用 程序 。 如 果 一 个 用 户 通 过 门户 网 站 的 导航 菜单 ， 然 后 返 
回 到 原来 的 应 用 程序 ， 则 它 可 以 保留 它 离开 时 完全 相同 的 状态 。 

如 果 应 用 程序 使 用 了 继续 插头 ， 则 应 用 程序 导航 时 ， 应 用 程序 相应 会 话 〈S$ession) 会 保 
留 在 门户 内 。 然 而 ， 在 许多 情况 下 ， 完 全 关闭 导航 的 应 用 程序 可 能 是 明智 的 ， 也 是 绝对 必要 
的 。 在 这 种 情况 下 ， 不 能 为 接口 视图 配备 继续 插 涉 (Resume plug). 

(1) 方法 WDDOAPPLICATIONSTATECHANGE 

方法 WDDOAPPLICATIONSTATECHANGE 为 组 件 控制 器 的 方法 。 应 用 程序 的 状态 发 生 
变化 时 ， 该 方法 被 处 理 ， 即 当 应 用 程序 由 运行 状态 转换 为 暂停 状态 〈 由 挂 起 插头 中 断 应 用 ) 
时 ， 或 者 在 随后 通过 继续 插头 重新 启动 。 该 方法 从 而 取代 了 WDDOEXIT 方法 。 

应 用 程序 开发 可 以 (并 不 是 必需 的 ) WIRE 22 WDDOAPPLICATIONSTATECHANGE 
中 。 它 可 能 是 有 用 的 ， 如 在 程序 挂 起 时 删除 数据 库 的 锁 。 

当 应 用 程序 运行 在 门户 网 站 中 ， 如 果 在 设计 时 没有 实现 挂 起 操作 ， 门 户 导航 需要 谨慎 使 
用 挂 起 的 操作 。 继 续 插 涉 (Resume plug) 的 使 用 只 能 确保 某 个 应 用 程序 的 中 断 ， 而 不 会 导致 
门户 导航 退出 。 但 是 ， 如 采 应 用 程序 没有 运行 在 门户 中 ， 上 述 情 况 并 不 会 发 生 ， 此 时 可 以 不 
利用 门户 网 站 的 导航 机 制 。 

(2) 门户 之 外 的 Resume Plugs 和 Suspend Plugs 

如 果 用 户 想 在 一 个 纯粹 的 Web Dynpro 导航 中 ， 中 断 应 用 程序 并 保留 会 话 ， 则 必须 为 接口 视图 
相关 的 窗口 创建 一 个 挂 起 插头 (Suspend Plugs)， 并 在 适当 的 时 候 触 发 它 。 每 个 接口 视图 可 以 有 多 
个 标记 为 挂 起 插头 的 出 站 插头 。 触 发 挂 起 插头 也 导致 方法 WDDOAPPLICATIONSTATECHANGE 
的 调用 ， 方 法 WDDOEXIT 则 不 会 被 调用 。 挂 起 的 应 用 程序 的 URL 会 自动 传递 给 随后 的 应 用 
程序 ， 所 以 Web Dynpro 导航 中 可 以 通过 随后 的 应 用 程序 返回 到 原来 的 应 用 程序 。 

如 果 在 Web Dynpro ABAP 应 用 程序 中 出 站 插头 被 标记 为 挂 起 标记 , 则 这 可 能 会 导致 在 门 
户 中 应 用 程序 的 运行 时 错误 。 如 果 不 能 完全 确定 应 用 程序 的 执行 是 在 门户 网 站 之 外 ， 则 应 该 
避免 使 用 挂 起 插头 。 


e 


4.6 导航 应 用 实例 


4.6.1 ”业务 对 象 创建 
1) 按照 路 径 Chttp://xitst:50000/ij) 登录 门户 系统 ， 如 图 4-57 所 示 。 
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门户 内 容 | 多 属性 蔡 信 | CIPPESÉHE | webDynpro | 活动 报表 | KM 内容 | 协作 内 容 | 工作 六 内 容 


国 无 要 显示 的 项 目 ll Business Objects 


y ER 公共 部 分 
il al | 


T: LE Fi 


Hu M T: 

b CJ com.sap.ip.collaboration f Ruk, — 

y d023033 Tm d 
y NSP ill il m £l 
» C) specialist IE 

(CJ Systemlandscape : : 
» Test 

[ themes 

(Cunification 5.0 
y C visual Composer 门户 内 容 工作 室 提 供 开 发 和 管理 门户 内 容 的 中 心 | , ARAA 
) 门 模板 环境 : view, ME, 格式 ,工作 集 , 角色 和 数据 包 . 接口 结构 
站 出 can 查 忆 的 内 容 fl 主要 概念 

到 ES B TT 


4-57 


EAR F, H BU tE “Context” 3H H] “Business Objects", TZ RE 4-58 
PTR HI KRITE CI, 


k| HFE 


4-58 


HS) spP E] 4-59 所 示 。 


新 文件 来 


文件 夹 名 称 :* 
= | cà = 


arts gu Sg C 示例 : com.companynarme): 


主语 言 : * 
[中 文 | 


描述 : 


I 


[4] 

文件 来 标识 
口 
Eca 
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HEARE Akiak. 
2) M “Context” KAPPIE CEA ERE” , TZRRIE] 4-60 所 示 的 路 径 创 建 业 务 
HZ. 


DJ 


业务 对 象 添 加 页 面 如 图 4-61 Przk 


业务 对 象 名 称 


系统 别名 :* ”6 现 有 的 [SAP NSP 下 CW 的 | 
eS SER. * jcomsapNavigate Ob] U | 


4-60 4-61 


填写 名 称 、 标识 等 EH, 单 击 SEIT 按钮 ， 结果 如 图 4-62 所 示 。 


[FEE] [WIS] [关闭 ] 
添加 系统 提供 的 业务 对 象 到 选 定 文件 严 


sk [  —] 
xe [s] EE 


LI MM S LL 


图 4-62 


单 击 [可 让 | 按钮 ， 保 存 新 建 业 务 对 象 。 
3) 编辑 新 建 业 务 对 象 ， 为 其 添加 工序 ， 如 图 4-63 所 示 。 


b Collection 


Ó—r 
> com.sap portal.pcm.Description [ | i 
b Domain L Ef 
bPcD fir 
— IE 
在 运行 时 请 使 用 该 门户 目录 执行 添加 view 或 页 面 的 操作 dati 
Ee 
E I qo 
M 原始 语言 -w——s 
bp 对象 类 型 
"已 分 配 的 查询 引擎 (DQE) 名 称 |SAP_NSP.com sap Navigate Obj | 


图 4-63 


Bem, ful 4-64 所 示 。 
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尾 性 竹 辑 器 -FMH 
t E Ix 


b Collection 


- 
qo 
| 
| 


| b com.sap.portal.pcm.Description 


b Domain 


PPCD 位 置 
y| h] 26 n 
PRIMER 
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填写 名 称 、 标 识 等 信息 ， 单 击 [ 苏 玉 按钮， 编辑 结果 如 图 4-65 所 示 。 
4) 在 门户 内 容 文 件 夹 内 ， 选 择 iViewEdEREREEL, AJ Bus JI LY 2) B6 iView。 


VEF% iView, "aut BU BE, 按照 以 下 路 径 打 开 编辑 页 面 如 图 4-66 所 示 。 


许可 
相关 链接 
基于 对 加 的 导航 


动态 导航 
H REHE ETa 
4-65 4-66 


基于 对 象 的 导航 页 面 显 示 如 图 4-67 所 示 。 


Eo [关闭 ] [9855] 


显示 : [基于 对 象 的 导航 >| 


通过 自 门 户 目 录 中 选择 工序 来 添加 工序 到 "Test" . 此 iview 在 运行 时 间 执 行 它们 . 


BEBE 
LS | 
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M "Context" JRP PIE Lo, 成绩 查 询 ， 单 击 鼠 标 右键 ， 按 照 图 4-68 所 示 的 路 径 
将 工序 添加 到 iView。 
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添加 操作 到 View 


图 4-68 


ZH KI 4-69 Br. 


IE EE 显示 : [基于 对 象 的 导航 >] 


基于 对 象 的 导航 


通过 自 门 户 目录 中 选择 工序 来 添加 工序 到 "Test" . 此 iYiew 在 运行 时 间 执 行 它们 . 


工序 名 称 ”显示 名 称 ENR WR 
(« | 成绩 查询 [BEER | 导航 对 象 [1 | 


BHEBEEBH Wan 


图 4-69 


E: 该 过 程 也 可 以 将 业务 对 象 打 开 ， 选 中 要 操作 的 工序 ， 单 击 iView， 根 据 相 关 菜 单 将 iView 
分 配给 工序 。 


4.6.2 ”应 用 程序 创建 


1) ABAP 工作 台 编辑 画面 创建 Web Dynpro 组 件 
选中 “Web Dynpro Comp./Intf. - ", 在 相应 的 文本 框 中 输入 程序 的 名 称 ， 如 图 4-70 所 示 。 


Web Dynpro Comp. / Intf. * | 
[ZWD. PORTAL NAVIGATION wl 
[€ J> J [e] [A] | 


图 4-70 


创建 Web Dynpro 组 件 如 图 4-71 所 示 。 


[c Web Dynpro: Component / Create Interface 
Name | ZWD PORTAL NAVIGATION 
Description 门户 导航 

TYPe (e Web Dynpro Component 


COWeb Dynpro Component Interface 


Window Name W PORTAL NAVIGATION | 


[rs JI 
E dj 
加 四 
图 4-71 
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编辑 Web Dynpro 组 件 如 图 4-72 所 示 。 


Object Name | Description | 
- dj ZWD PORTAL MAVIGASTION | 门户 导航 
: b COMPONENTCONTROLLER l'1P 5 B.----:HPETRP RS 
7 di Component Interface 
: d INTERFACECONTROLLE l'1P B.----:H PETERS 
~ EE Interface Views 
. [E] w PORTAL MAVIGA[TPI E Br---- Eri 
- LL views 
* E] v MAIN 门户 导航 ---- 视 图 
”windows 
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2) 在 ABAP 工 作 人 台中 的 编辑 界面 编辑 视图 。 
选择 视图 V_ MAIN， 选 中 “Layout” 选 项 卡 ， 插 入 UI 元 素 如 网 4-73 所 示 。 


* [ | CONTEXT_MENUS 

- | ]ROOTUIELEMENTCONT AIMER 
. = | TA OBJECT 
. = | TA ABSOLUTE 


4-73 
编辑 布局 如 图 4-74 所 示 。 
对 象 导航 
354 Bi 
相对 导航 
4-74 


为 LinkToAction 类 UI 元 素 LTA_ OBJECT 创建 动作 如 图 4-75 所 示 。 


Component ZWD PORTAL NAVIGATION 
View V MAIN 
Action TO OBJECT 


um rr: a 
Description UTI r r L 


[ |Transfer UI Event Pararneters 
v^] S 
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动作 处 理 程 序 编辑 如 下 : 


METHOD ONACTIONTO OBJECT . 
DATA LO API COMPONENT TYPE REF TO IF WD COMPONENT. 
DATA LO PORTAL MANAGER TYPE REF TOIF WD PORTAL INTEGRATION. 
LO API COMPONENT = WD COMP CONTROLLER-^WD GET API( ). 
LO PORTAL MANAGER = LO API COMPONENT--GET PORTAL MANAGER( ). 
LO PORTAL MANAGER-^NAVIGATE TO OBJECT( 
SYSTEM —'SAP NSP' 
OBJECT TYPE —'com.sap.Navigate Obj' 
OBJECT VALUE NAME — 'objectValue' 
OBJECT VALUE — OBJECT VALUE 
OPERATION = 'Test 
BUSINESS PARAMETERS — BUSINESS PARAMETERS 
FORWARD OBN METADATA = ABAP FALSE 
USE FORWARDPARAMETERS OF AL = ABAP FALSE 
RESOLVING MODE = CO RESOLVING MODE-SOURCE ROLE 
). 
ENDMETHOD. 


为 LinkToAction 类 UI 元 素 LTA ABSOLUTE 创建 动作 如 图 4-76 所 示 。 


LÆ Create Action 
Component ZWD PORTAL NAVIGATION 
View V MAIN 
Action TO ABSOLUTE 
pee— 


Description SECHS, 


[Transfer UI Event Parameters 


图 4-76 


动作 人 处理 程序 编辑 如 下 : 


METHOD ONACTIONTO ABSOLUTE. 
DATA LO API COMPONENT TYPE REF TO IF WD COMPONENT. 
DATA LO PORTAL MANAGER TYPE REF TO IF WD PORTAL INTEGRATION. 


LO API COMPONENT = WD COMP CONTROLLER-^WD GET API( ). 
LO PORTAL MANAGER = LO API COMPONENT--GET PORTAL MANAGER( ). 
LO PORTAL MANAGER-^NAVIGATE ABSOLUTE( 

NAVIGATION TARGET -'ROLES:/portal content/NSP/Test 


NAVIGATION MODE -IF WD PORTAL INTEGRATION--CO SHOW INPLACE 
WINDOW FEATURES = WINDOW FEATURES 

WINDOW NAME = WINDOW NAME 

HISTORY MODE  =IF WD PORTAL INTEGRATION-»CO NO DUPLICATES 
TARGET TITLE = TARGET TITLE 

CONTEXT URL = CONTEXT URL 

POST PARAMETERS = ABAP. FALSE 
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USE SAP LAUNCHER = ABAP. TRUE 
BUSINESS PARAMETERS = BUSINESS PARAMETERS 
LAUNCHER PARAMETERS = LAUNCHER PARAMETERS 


). 
ENDMETHOD. 


为 LinkToAction 类 UI 元 素 LTA RELATIVE 创建 动作 如 图 4-77 所 示 。 


[=> Create Action 


Component ZWD PORTAL NAVIGATION 
View V MAIN 
Action (TO RELATIVE Ø 
Description 相对 导航 
Transfer UI Event Parameters 
yx] E 
A] 4-77 


动作 处 理 程序 编辑 如 下 : 


METHOD ONACTIONTO RELATIVE. 
DATA LO API COMPONENT TYPE REF TO IF WD COMPONENT. 
DATA LO PORTAL MANAGER TYPE REF TOIF WD PORTAL INTEGRATION. 


LO API COMPONENT = WD COMP CONTROLLER-^WD GET API( ). 
LO PORTAL MANAGER = LO API COMPONENT--GET PORTAL MANAGER( ). 
DATA:LT PATH TYPE STRING TABLE,LV PATH TYPE STRING. 
LV PATH -'NSP'. 
APPEND LV PATH TOLT PATH. 
LV PATH = "Test. 
APPEND LV PATH TOLT PATH. 


LO PORTAL MANAGER-^*NAVIGATE RELATIVE( 

BASE URL — 'ROLES://portal content/NSP/Navigation' 
LEVELS UP = '2' 
PATH =LT PATH 

NAVIGATION MODE -IF WD PORTAL INTEGRATION=>CO SHOW INPLACE 
WINDOW FEATURES -WINDOW FEATURES 

WINDOW NAME — WINDOW NAME 

HISTORY MODE =IF WD PORTAL INTEGRATION--CO NO DUPLICATES 
TARGET TITLE — TARGET TITLE 

CONTEXT URL — CONTEXT URL 

USE SAP LAUNCHER = ABAP TRUE 

BUSINESS PARAMETERS - BUSINESS PARAMETERS 

LAUNCHER PARAMETERS - LAUNCHER PARAMETERS 

POST PARAMETERS = ABAP FALSE 

). 
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ENDMETHOD. 


3) 在 ABAP 工作 台中 的 编辑 界面 创建 Web Dynpro Application 如 图 4778 所 示 。 


[E Create Web Dynpro application 


Application zwd. portal. navigation | 
T 3 
Description TPSA | 
E A 


x). 
4-78 
创建 Web Dynpro 应 用 程序 的 iView: 


在 应 用 技术 〈Application Technology) HWP, Xf% Web Dynpro ABAP 应 用 程序 ， 创 
建 一 个 Web Dynpro ABAP 应 用 程序 的 iView， 如 图 4-79 所 示 。 


iView Fi 


源 类 型 。 页 面 创建 SË 
基于 以 下 之 一 的 新 视图 : 
他 视图 模板 一 根据 现 有 视图 模板 来 创建 视图 


个 门户 组 件 一 创建 包含 在 部 署 门户 归档 ( PAR ) 交 件 中 的 门户 组 件 的 视图 
C Web Dynpro 应 用 程序 一 ”根据 部 署 Web Dynpro 应 用 程序 创建 视图 
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TH, HUP 4-80 所 示 。 


| 
| iView Fi 5e 


步骤 1: 模板 选择 

CKM misa TIG Mas iView E 
CSAP BSP iView 

CSAP IAC iview 

CSAP Mini&pp iVievv 

CSAP RFC iView 


CSAP 事务 iview 

(CURL iView 

CwWeb 服务 iview 

(CKML iView 

个 代理 到 | Portlet iview (NSRP) 
个 协作 配置 模板 

个 工作 集 映射 iview 

个 服务 映射 ivieww 

站 没有 内 容 过 滤器 的 KMI view 
个 相关 服务 view 

号 门户 活动 报表 iew 


E T 
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选中 “SAP Web Dynpro iView” 单 选 按钮 ， 单 击 
62 


MH. Un 4-81 所 示 。 


步骤 2: 常规 属性 
iView 名 称 :* 
Bs 


iView 标识 : * 
Nego] 0] 
iview PRRI (DAD: com .公司 名 称 】: 


4-81 


填写 必要 的 信息 ， 单 击 [= 丰 


按钮 ， 如 图 4-82 所 示 。 


DR0] E - — — [完成 ] 


ba Kr Web Dynpro Platform 
Select whether you want to create a Web Dynpro for Java or Web Dynpro for ABAP iView 


Platform: * 
ie eb Dynpro for ABAP 
Ceb Dynpro for Java 
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选中 “Web Dynpro forABAP” 单 选 按钮 ， 单 击 区 


[R] EE ES [元 成 


Wi: Web Dynpro Parameters 


Enter the parameters of the Web Dynpro application for which you want to create the iview 
System: * 
[sap NsP "| 
Namespace: * 
Application Name: * 
zwd porta navigation| s 


Web Dynpro Client: 
(«Plain HTML 
CuWindowes Client 
C Java Client 


Configuration Name: 


Application Parameters: 
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DRE] DEET] A E) 
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填写 必要 信息 ， 单 击 EEET 


按钮 ， 如 图 4-84 所 示 。 


235: DES 
iview 名 称 :: 导航 示 便 
iview 标识 :: Navigation 
主语 言 :: ru 
System: SAP NSP 


WebDynproMamespace: sap 
WebDynproApplication: —zwved portal navigation 


ClientType:: HTML 
DefinitionType:: ABAP 
口 当 向 导 完 成 时 将 其 打开 进行 编辑 
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确认 信息 无 误 ， 单 击 杞 出 按钮 ， 并 将 其 属性 “输入 


Dee [a e] A] 


登录 语言 

监视 器 命中 

窗口 特征 

' 9 系统 
» £18 2:888] Rf [o pa (o pett 


y 8485831] [None >] 
， 请 和 将 参数 转发 到 webDymro[L | 


pum 


输入 点 ee CS 

配置 名 称 | 
REDA URL v 

MES IP. PTL INITIAL. CONTENT 


验证 方案 | default M | 
高 度 类 型 [FixED y] 


p 


TARA] 


BA) DERI] [下 一 个 -| RSS] 


AN “æ”, WME 4-85 Hr. 


[L | 
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编辑 结果 如 图 4-86 所 示 。 


com.sap.ip.collaboration 
» 73022033 
wÍ NSP 
[z] 导航 示例 
EE 
FA 班级 成 员 
E=] 班级 成 员 查 询 男 面 
E 班 纸 成 员 查 询 结 果 男 面 
p C specialist 
(CJSystemlandscape 


rL Test i 
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4.6.5 ”应 用 程序 导航 测试 


(1) 创建 门户 角色 


D) 在 门户 内 容 文件 来 下 ， 用 鼠标 右键 单 击 “Context” 末 时 中 的 “ 口 加 ”按照 图 4-87 所 
不 的 路 径 创 建 角 色 。 


ECE v 
打开 > 页 面 
刷新 

更 疏 标识 
Bs 

复制 itx 
EI 


图 4-87 
角色 创建 癌 导 初始 界面 如 图 4-88 PTR o 

角色 向 导 
步骤 1: 常规 属性 
角色 名 称 :* [4] 
[导航 角色 
角色 ID: * 
Api (例如: com .公司 名 称 ) : 
FEE 
[ez — x 
描述 : 

Í [7] 

EN —— JE: 
图 4-88 


填写 必要 的 信息 ， 单 击 [ET 


角色 向 导 


步骤 2: 
主语 言 PH 


LES 


角色 ID: — Role Navigation 
角色 名 称 :: 导航 角色 


E EE T 
图 4-89 
HEAR, hE. 


2) 打开 角色 对 和 象 编辑 画面 ， 选 中 国电 济 浊 科目 呈 晤 
示 路 径 将 iView 添加 至 角色 。 


E, rh bnaE, TERRE 4-90 所 


65 


66 
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编辑 结果 如 图 4-91 所 示 。 


OETA > BESES - 导航 角色 A 
E 导航 示例 属性 类 别 [显示 全 部 v] 
E=] 成 顷 查 询 
b ACLAdministration CE CR 
> AciSuperliser CE CR 
> admin impersonation CE CR 
» Administrate CE G3 
» Administrate CE G3 
b Administrate CE CR 
> Administrator CE G= 
h AllButalueMapping CE G3 
h Applications. Configure CE G3 
AEAF ] [BIER | | E997 ] | SCIT ] [RT ] 
EE HE 154 > Applications. Display CE CR 
AFR ERRA [MARA] > Applications. Start. Stop CE G3 [y] 


4-9] 
(2) 分 配 门户 角色 
狐 建 角色 分 配给 登录 用 户 ， 如 图 4-92 所 示 。 


L4 


已 分 配 的 角色 ， 


已 分 配 的 角色 
BREE [| —— 0 [mese 进行 | 


| pcd portal, contentANSP/Role, Navigation | 导航 角色 门户 角色 


| | | 
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(3) 测试 门户 导航 
按照 路 径 (http://xitst:50000/irj ) 用 分 配角 色 后 的 用 户 登 录 门 户 系统 。 
fats "WP" KE, tu] 4-93 所 未。 


Th 导航 示例 - SAP NetFeaver Portal - Hicrosoft Internet Explorer 
FO 编辑 于) EEV WEG) IAD 帮助 加) 

Q mi - O- [3 [ @ | D cux ole 5 BA 
HAE O | 入 http://xitst. sap. com:50000/irj/portal 0 


D 无 要 显示 的 项 目 


4-93 


分 别 单 击 各 个 链接 ， 导 航 结 末 如 图 4-94 所 示 。 


Th - SAP HetFeaver Portal — Microso ft Internet Explorer 
THO 编辑 下) SEV WEG) IAT)  $B»500 
QRmB-O-i iz 5| sk ux 60-55 
Hi QD |) http: //xitst. sap. com: S0000/ir j/portal 


I) 无 要 显示 的 项 目 


班级 
学 年 : |2009 
成 绩 查 询 结果 
显示 详细 更 新 详细 


PEES HZA 语文 成 绩 ”数学 成 绩 “自然 成 绩 。” 思 品 成 绩 


图 4-94 


4.7 工作 保护 模式 (Work Protect Mode» 


工作 保护 模式 提供 了 基础 设施 ， 用 于 处 理 在 SAP NetWeaver 门户 中 未 存储 的 数据 。 如 果 
一 个 应 用 程序 所 输入 的 数据 还 没有 被 保存 ， 那 么 这 个 应 用 程序 被 称 为 “dirty”。 正常 情况 下 ， 
数据 丢失 是 因为 当 用 户 导 航 到 另 一 个 应 用 程序 时 没有 事先 保存 数据 。 为 了 防止 这 种 情况 的 发 
生 ， 门 户 的 客户 端 框架 监控 所 有 应 用 程序 的 当前 状态 。 

示例 : 工作 保护 模式 下 的 对 话 框 ， 如 图 4-95 所 示 。 


| Z SAP Enterprise Portal 6.0 -- Web Page Dialog Es ES 


i Continue with navigation and open new window 
(^ Go back to your page and save data 
(^Dizcard changes and open content in same window 


Kok || cancel 


图 4-95 


应 用 程序 必须 定义 一 个 特殊 的 标识 (dirty)， 当 有 未 保存 的 数据 时 它 告诉 门户 网 站 。 程 序 员 可 
以 使 用 接口 IF WD PORTAL INTEGRATION 中 的 方法 SET APPLICATION DIRTY_FLAG 设置 
和 取消 该 状态 标识 《TRUE，FALSE)。 如 果 该 标识 设置 为 TRUE 时 ， 则 在 新 窗口 中 目 动 执行 每 个 
导航 步 又 。 未 保存 的 数据 将 被 保留 在 原来 的 窗口 。 这 意味 着 用 户 可 以 切换 到 原来 的 应 用 程序 保存 
数据 。 

下 面 的 源 代 人 显示 了 如 何 设置 该 状 态 : 
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data L COMPONENTCONTROLLER type ref to IG COMPONENTCONTROLLER . 
data L API COMPONENTCONTROLLER type ref to IF WD COMPONENT. 

data L PORTAL MANAGER type ref to IF WD PORTAL INTEGRATION. 

L COMPONENTCONTROLLER = WD THIS--GET COMPONENTCONTROLLER CTR( ). 
L API COMPONENTCONTROLLER =L COMPONENTCONTROLLER-WD GET API(). 


L PORTAL MANAGER-L API COMPONENTCONTROLLER--GET PORTAL MANAGER( ). 
call method L PORTAL MANAGER-^SET APPLICATION DIRTY FLAG 

exporting 

DIRTY FLAG - TRUE | FALSE. 


Web Dynpro 文 持 以 下 3 种 不 同 的 工作 保护 模式 〈 接 口 正 WD PORTAL INTEGRATION 
的 方法 SET WORK. PROTECT MODE): 

1) NONE。 该 值 表 示 工 作 保 护 模 陈 不 和 被 Web Dynpro 应 用 程序 所 使 用 。 在 门户 网 站 中 如 
果 导 航 到 另 一 个 应 用 程序 ， 则 未 保存 的 数据 将 丢失 ， 即 使 设置 了 “dirty” 标 志 。 

2) APPLICATION_ONLY。 访 值 表 示 Web Dynpro 应 用 程序 本 里 决定 是 耕 有 未 保存 的 数 
据 。 也 就 是 说 ， 应 用 程序 是 否 是 “dirty” 的 。 这 就 是 为 什么 “dirty” 的 状态 只 在 服务 器 端 监 控 。 
即使 使 用 这 个 值 ， 也 不 能 保证 尚未 传送 到 服务 器 中 的 数据 不 会 去 失 。 

3) BOTH。 该 值 表示 客户 端 也 检查 “dirty” 的 状态 。 这 确保 了 没有 用 户 输 入 的 情况 下 ， 
尚未 传送 到 服务 器 将 会 丢失 。 这 是 通过 设置 SAP 企业 门户 中 应 用 程序 “dirty” 状 态 ， 一 旦 用 
户 已 经 输入 了 数据 ， 该 数据 就 不 会 丢失。 

Web Dynpro 应 用 程序 在 运行 期 间 可 根据 需要 改变 上 述 模式 。 例 如 ， 当 用 户 从 一 个 视图 导 
航 到 另 一 个 时 可 以 改变 模式 。 在 一 个 视图 上 ， 输 入 学 段 并 进行 数据 保存 可 能 是 有 意义 的 。 在 
这 种 情况 下 ， 访 模式 应 定义 为 BOTH 或 APPLICATION ONLY。 画 一 个 视图 上 认为 这 种 保护 
模式 可 能 没有 必要 。 在 这 种 情况 下 ， 模 式 应 定义 为 NONE., 

下 面 的 源 代码 显示 了 如 何 设置 该 模式 ; 

DATA LR COMPONENTCONTROLLER TYPE REF TO IG COMPONENTCONTROLLER . 
DATA L API COMPONENTCONTROLLER TYPE REF TO IF WD COMPONENT. 
DATA L PORTAL MANAGER TYPE REF TO IF WD PORTAL INTEGRATION. 


L COMPONENTCONTROLLER = WD THIS->GET COMPONENTCONTROLLER CTR( ). 
L API COMPONENTCONTROLLER =L COMPONENTCONTROLLER-^WD GET API( ). 


L PORTAL MANAGER = L API COMPONENTCONTROLLER-^GET PORTAL MANAGER( ). 
CALL METHOD L PORTAL MANAGER-^SET WORK PROTECT MODE 
EXPORTING 
MODE - NONE | APPLICATION ONLY | BOTH. 
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第 5 苹 ”集成 表单 (Integrating Forms ) 


Web Dynpro 用 户 界 面 ， 表 单 可 以 直接 创建 或 使 用 基于 Adobe 的 Interactive Forms. X f 
ETHE AFA, n LEH Adobe LiveCycle Designer LEE fr $T TIER IARE ae 
Adobe UI 元 素 中 。 

对 NetWeaver 7.0 (NW7.0) SPSIO 以 上 的 版 本 ， 表 单 格式 可 以 集成 使 用 Zero Client 
Installation (ZCI). 

it: NetWeaver 7.0 SPS10，SAP 强 烈 建议 使 用 ZCI 形 式 的 XML 接口 。 由 于 额外 的 中 央 功 能 已 添 
加 到 随后 的 SP (输入 帮助 和 下 拉 式 列表 框 ) 中 ，SAP 一 般 建议 使 用 Web Dynpro ABAP 最 新 支持 包 。 

SAP 建 议 始终 使 用 表单 的 XML 接口 。 现 有 基于 ABAP 字 典 接口 形式 的 表单 ， 可 以 用 作 打 
印 形式 。 不 建议 这 些 表单 使 用 互动 形式 。 

使 用 基于 Adobe 的 SAP Interactive Forms 的 解决 方案 有 以 下 几 种 方式 : 

1) 打印 。 广 方案 用 于 打印 和 显示 表单 。 与 互动 场景 不 同 ， 这 里 使 用 的 是 唯一 的 非 输入 蕊 
能 的 PDF 表格 (PDF 的 打印 表单 )。 

2) 互动 《交互 )。 这 种 情况 下 ， 表 单 包 含 输入 功能 的 元 素 并 可 以 编辑 。 

SAP 建议 用 户 经 过 仔细 检 伍 应 用 要 求 后 ,判断 是 否 使 用 互动 表单 。 如 果 基 于 PDF 的 形式 
确实 比 一 个 正常 的 Web Dynpro 视图 有 优势 ， 则 可 以 考 卡 使 用 该 方法 。 

3) 离线 应 用 。 系统 中 已 经 存在 的 From 作为 MIME 文件 对 象 的 形式 存储 在 MIME 信息 库 
中 ， 或 上 传 〈 文 件 上 传 )》 到 Web Dynpro 应 用 程序 用 于 显示 。 

4) 数字 签名 。 创 建 或 使 用 有 关 表 格 的 程序 很 大 程度 上 应 用 于 六 两 个 方案 。 然 而 ， 当 调用 
应 用 程序 时 与 ACF 表单 有 一 个 本 质 的 区 别 : 当 第 一 次 调用 表单 时 ， 一 个 CAB 文件 (其 中 包 
含 一 个 在 本 地 Adobe Reader 的 插件 ) 2 H 2J JA HR %% JI 3k 222. EB Active Components 
Framework (ACF) 服务 ， 该 服务 允许 用 户 在 本 地 计算 机 上 处 理 表 单 的 内 容 。 然 而 ，ACF 没有 
所 需 的 显示 或 打印 的 机 制 。 

(1) 客户 端 安装 (ZCI) 和 有 效 组 件 框架 (ACF) 

在 ISR 框架 中 交互 表单 是 ZCI 的 一 部 分 。 在 ZCI 的 基于 Web Dynpro ABAP 中 ， 它 们 可 
以 在 运行 中 被 用 作 SAP NetWeaver SPS10。 要 局 用 该 功能 ， 表 单 必须 包含 特殊 脚本 ， 议 脚本 可 
以 在 表单 生成 器 创建 新 的 表单 时 插入 。 

到 现在 为 止 , 需要 在 前 并 PC 上 安装 Active Component Framework (ACF) 以 便 互 动 报 表 。 
作为 SAP NetWeaver 7.0 SPS10, ZCI 可 以 使 用 户 在 没有 任何 额外 的 插件 情况 下 用 Adobe Reader 
显示 互动 报表 。ACF 因此 不 再 需要 互动 表单 。 可 以 使 用 报表 制作 与 SAP NetWeaver ZCI 旧版 
本 兼容 的 任何 交互 式 表单 。 

(20 连接 测试 

测试 ZCI 运行 报表 FP CHK REPORT. 

测试 ACF 执行 报表 FP PDF TEST 00， 以 确保 ADS 正确 配置 。 如 果 配 置 是 正确 的 ， 则 
测试 程序 将 输出 安装 的 ADS 版 本 号 。 

(3) 使 用 表单 创建 Web Dynpro 应 用 
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EHI ERAS (事务 代码 : SEP) 可 以 创建 和 维护 表单 。 请 注意 ， 在 Web Dynpro ABAP 
中 不 支持 兼容 的 智能 表单 接口 。 原 则 上 可 以 在 任何 组 件 的 任何 视图 中 整合 任意 表单 ， 但 通 芝 
在 一 个 单独 视 铭 中 整合 表单 比较 好 。 


5.{ 集成 表单 条 件 


1. 一 般 条 件 

(1) 安装 SAP NetWeaver AS 系统 并 附 有 Adobe Document Services (ADS) 功 能 

要 测试 连接 到 ADS， 运 行 报告 FP_PDF_TEST_00， 将 显示 ADS 版 本 信息 。 如 末 这 个 测 
试 是 成 功 的 ， 运 行 报告 FP_TEST_00。 选 择 一 台 打 印 机 ， 选 择 打 印 预 史 选项 。Adobe 3 Vids 
现 ， 并 显示 一 个 人 简单 的 表单 。 

(2) 语言 设置 

要 显示 表单 所 需 的 语言 ， 用 户 必 须 指定 相 结 合 的 语言 和 区 域 设置 (国家 )， 并 提供 必要 的 
翻译 。 可 以 指定 用 户 配 置 文件 中 (事务 SU52) 的 参数 标签 页 的 国家 代码 。 输 入 UCN 作为 参 
数 了， 并 和 输入 所 要 求 的 国家 短 代 码 作 为 参数 值 ， 然 后 保存 条 目 。 

2. ZCI 

(1) 系统 要 求 

1) SAP NetWeaver NW 7.0 SPS10 或 更 高 版 本 。 

2) SAPGUI Release 6.40 Support Package Level 20 或 更 高 版 本 。 

3) Adobe LiveCycle Designer 7.1, support package level 1 或 更 高 版 本 。 

(2) ZCI 表单 要 求 

1) Adobe Reader Version 7.08 或 更 高 版 本 。ZCI 和 HTTPS 需要 Adobe Reader 8.1. 

2) Adobe Designer, version 7.1 SP 1 或 更 高 版 本 。GUI patch level 20 必须 安装 。 

3) 交互 表单 属性 。 

€ Web Dynpro ABAP 视图 设计 器 内 对 于 InteractiveForm UI 元 素 的 enabled 属性 设置 为 true. 

e 属性 displayType 区 分 ZCI (选择 Native) 和 非 ZCI (选择 ACF)， 如 图 5-1 所 示 。 


Property Value [Binding | 
Properties (InteractiveForm) 
D INTERACTIE FORM | 
Layout Data MatrixHeadData i 
additionalArchives 
dataSource V1.TEST. DATA 
===] 
= 
pdfSource L |] 
readOnly L |] 
templateSource ZKRADOBEO 
tooltip 
visible Visible Ë) — 
width 300px L |] 
Events 
onSubmit GO m 
图 5-1 


4) 表单 设计 器 (事务 代码 : SFP). 
e 布局 类 型 的 属性 设置 为 ZCI 布局 ， 如 图 5-2 所 示 。 
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Properties 


Description | | 


This farm uses an «ML schema-bhased interface. 


Layout Type Zl Layout t] 


< 5-2 


e 在 表单 中 使 用 的 Web Dynpro Native library, "IK 5-3 所 示 。 


" 


Web Dynprd Web Dynpro Native “ay 


图 5-3 
e 在 表单 中 插入 ZCO 脚本 实用 程序 ， 如 图 5-4 所 示 。 


Utilities Environment System Help 


i Settings... 

° Display Object List Gtrieshift-F5 

l Warklist j 

| Display Navigation Window Ctrl+Shit+tF4  ! 
i LI Tum form... 


Downloading farm... 


Uploading subtree... 


| 


| 


Downlaadindg subtree.. 


PE 


versions 
图 5-4 


之 后 ， 在 视图 设计 器 中 可 以 看 到 ContainerFoundation JS. 

可 能 需要 更 新 所 使 用 的 模板 使 用 报表 程序 : FP_CHK_REPORT)。 

3. ACF 

1) 安装 SAP NetWeaver AS 系统 并 附 有 Adobe Document Services (ADS) 功 能 。 
2) 必须 在 本 地 计算 机 上 安 狼 Adobe Reader (7.0 以 后 版 本 )。 


5.2. Æ Web Dynpro 应 用 中 集成 PDF 表单 


在 程序 中 设置 打印 表单 和 互动 表单 的 属性 时 ，InteractiveForm 只 有 两 个 属性 : 


templateSource 和 dataSource。templateSource 属性 包含 表单 模板 的 信息 ， 而 绑 定 到 DataSource 
属性 的 Context 节点 属性 包含 显示 在 表单 上 的 值 。 


可 以 以 XML 格式 存储 或 处 理 表 单 ， 完 成 在 运行 时 由 用 户 和 输入 的 值 。 要 做 到 这 一 点 ， 在 


视图 Context 中 必须 包括 一 个 额外 的 属性 , 类 型 为 XSTRING, 然后 将 其 绑 定 到 InteractiveForm 
UI 元 素 的 pdfSource 属性 。 
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这 样 就 可 以 读 取 和 人 处理 XML 格式 表示 的 PDF 值 。 使 用 合适 的 模板 和 XML 数据 ， 可 以 
在 不 同 的 应 用 中 创建 完整 的 PDF。 

i£: pdfSource 属性 的 绑 定 类 型 为 XSTRING， 其 内 容 源 于 后 台 ， 表 单数 据 由 后 台 到 单独 
Web Dynpro Context 节点 的 属性 的 传输 不 被 支持 。 


5.3 ”插入 互动 表单 


由 于 Web Dynpro 应 用 程序 中 插入 用 于 打印 和 互动 的 表单 之 间 的 差异 非常 小 , 因此 这 两 种 
情况 下 的 程序 可 以 一 起 提供 。 

在 Web Dynpro 应 用 中 使 用 静态 表单 ， 如 PDF 打印 表格 ， 表 格 可 以 用 来 显示 或 打印 数据 。 

在 互动 表单 的 情况 下 ， 可 以 重复 使 用 用 户 和 输入 的 内 容 ， 该 内 容 存 储 在 Web Dynpro 应 用 程 
序 的 Context 中 。 

注 : 在 templateSource/ dataSource 都 被 绑 定 的 情况 下 ， 如 果 ADS 可 用 ， 则 表单 才能 被 创 
建 。 另 一 方面 ，pdfSource 的 属性 在 这 种 情况 下 被 忽略 ， 请 注意 以 下 几 点 : 

1) 如 果 将 enabled 设置 为 TRUE， 则 显示 表单 通过 ACF. 

2) 如 果 readOnly 设置 为 只 读 ， 则 没有 可 以 输入 或 修改 的 形式 。 

3) 如 果 enabled 选项 没有 设置 ， 则 没有 ACF 的 形式 显示 ，readOnly 属性 将 被 忽略 。 


5.3.4 TE Web Dynpro 应 用 中 使 用 Adobe Forms 


1) 在 ABAP 工作 台中 的 编辑 界面 创建 Web Dynpro 组 件 。 
选中 “Web Dynpro Comp./Intf.”， 在 相应 的 文本 框 中 输入 程序 的 名 称 ， 如 图 5-5 所 示 。 


Web Dynpro Comp. / Intf. v 


IZWD ADOBE FORM| wise. 
图 5-5 


创建 组 件 如 图 5-6 所 示 。 


[> Web Dynpro: Component / Create Interface 


Name ZWD ADOBE FORN 
Description 成 绩 信 息 榨 索 
Type («Web Dynpro Component 


(Web Dynpro Component Interface 


Window Name W ADOBE 
View Name Y MAIN 


编辑 组 件 如 图 5-7 所 示 。 


Ja 


Object Name | Description - 
~ dj ZWD ADOBE FORM 学 生 信 息 检索 
- vb COMPONEMTCONTROLLER |5E^E18 fuse —RE TH TE mS 
= d Component Interface 
: vb INTERFACECON TROLLEI 
- FE Interface Views 


SE^EÍR Ritus —SB PET? Blas 


: Él w ADOBE SES BASE S 
= E Views EN 
: E] v. MAIN ES B 45341 E 


- [E Windows - 
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2) 在 ABAP 工作 台中 的 编辑 界面 编辑 Web Dynpro 视图 。 
选中 左 侧 树 形 冯 单 中 的 视图 V_MAIN， 选 择 “Layout” 选 项 卡 ， 创 建 容器 类 UI 元 素 
GRP TEST KEY， 添 加 按钮 及 Interactive Form 元 素 ， 编 辑 布 局 如 图 5-8 所 示 。 


View V MAIN Inactive(revised) 
; ^]nbound Plugs V Outbound Plugs |; Context (V Attributes 


* L] CONTEXT. MENUS 
~ [ ] ROOTUIELEMENTCONTAINER 
~ Ë] GRP. TEST. KEY 
* T CAPTION [Header] 


* oem] 
` Q ir TEST 
IND 4» 
Property Value BEEN 
: :Properties (Button) a 
InteractiveForm: IF TEST D BTN, SEARCH ` 


activate... B 

context... Inherit š 
context... 

design standard ü m 
enabled [v] [.] 
explanati... m 
hotkey None e 
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添加 “查询 ”按钮 动作 如 图 5-9 所 示 。 
[=> Create Action 


Al udia ZWD ADOBE FORM : | 


View V MAIN ] 


Description 成 绩 信息 查询 | | 


Select an outbound plug or enter an 
outbound plug for leaving the view 


by selecting the pushbutton 


Outbound Plug [ NS! 
Ir | 
"| 
MoE 
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用 InteractiveForm 元 素 属 性 templateSource 设 定 已 存在 Adobe 表 蛙 ZTEST FORM, 生成 
结果 见 表 5-] ° 
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参照 表单 自动 生成 Context 节点 及 属性 


“Context V-MAIN 


~ (D CONTEXT 


. E] ZTEST. FORM 


> [S] TEST 

* b ZZCLASS 
* $ ZZYEAR 
* $ ZZSTDNO 
* b ZZNAME 
* $ ZZTENKOK 
* $ ZZTENSAN 
* $ ZZTENRIK 
$ ZZTENSHA 


* $ NAME1 
* $ NAME2 
* $ YEAR 

* $ CLASS 


表 5-1 


表单 中 Context 节点 及 属性 


dt t£. z. | 描述 
”| zTEST FORM | 
~ [Ë] TEST 表 类 型 
~ ED DATA 
* o ZZCLASS 名 班级 
o ZZYEAR e 学 年 
o ZZSTDNO CE 
o ZZNAME e 姓名 
o ZZTENKOK B Sirta 
o ZZTENSAN 8 数学 成 顷 
o ZZTENRIK & 自然 成 绩 
。 D ZZTENSHA e 思 品 成 绩 
D NAME2 M 
D NAME1 ME 
D YEAR 学 年 
o CLASS HESR 


InteractiveForm 76 z& Jg PE: E un K] 5-10 所 示 。 
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addition. 
context... 


l [Interac weFormy 
IF_TEST 


TI 


Inherit 


context... 


dataSou 


displayT... 


enabled 
height 


pdfsource 
readonly 
templat. 


300px 


[] 
.. ZTEST FORM 


图 5-10 


根据 生成 的 Context 创建 成 绩 查 询 表 单 如 图 5-11 所 示 。 


'V MAIN 


| Inactive 


Inbound Plugs 


Outbound Plugs 


Y D] ROOTUIELEMENTCONTAI 


InteractiveForm: IF_TEST 


成 绩 信息 ~ 问 GRP_TESTKEY 
* T CAPTION [Header 
班级 : V MAIN.ZTEST  FORM.( i id s... 
学 年 :|V_MAIN.ZTEST_FORM. 查询 - T YEAR LBL 
ptt PPP rimara * Fe YEAR 


* sw BTN SEARCH 


IF TEST 


.. Inherit 4] 

… V. MAIN.ZTES... [E77 

.. native E 
[vi 

height 300px 

pdfSource 

readOnly B 


动作 SEARCH 的 处 理 程序 编辑 如 下 : 


METHOD ONACTIONSEARCH . 
* ”取得 输入 信息 
DATA LO ND ZTEST FORM TYPE REF TOIF WD CONTEXT NODE. 
DATA LO EL ZTEST FORM TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LS ZTEST FORM TYPE WD THIS--ELEMENT ZTEST FORM. 
$ navigate from «CONTEXT?» to <ZTEST FORM via lead selection 
LO ND ZTEST FORM = WD CONTEXT->GET CHILD NODE( NAME = WD THIS->WDC 
TX ZTEST FORM ). 
*  getelement via lead selection 
LO EL ZTEST FORM = LO ND ZTEST FORM--GET ELEMENTY( ). 
*  getall declared attributes 
LO EL ZTEST FORM->GET STATIC ATTRIBUTES( 
IMPORTING 
STATIC ATTRIBUTES = LS ZTEST FORM ). 
* 取得 班主 任 姓 名 
SELECT SINGLE A—ZTNAME 
B-ZTNAME 
FROM ZCCLASS T "班主 任 表 
INNER JOIN ZMTNUMBER T ASA 
ON ZCCLASS T-ZZTEANOM - A-ZTNUMBER 
INNER JOIN ZMTNUMBER T AS B 
ON ZCCLASS T-ZZTEANOS = B-ZTNUMBER 
INTO (LS ZTEST FORM-NAMEI ,LS ZTEST FORM-NAME2) 
WHERE ZZCLASS = LS ZTEST FORM-CLASS . "班级 
*  getall declared attributes 
LO EL ZTEST FORM-^SET STATIC ATTRIBUTES( 
EXPORTING 
STATIC ATTRIBUTES = LS ZTEST FORM ). 
* 取 得 成 绩 信息 
DATA LO ND TEST TYPE REF TOIF WD CONTEXT NODE. 
DATALT TEST TYPE WD THIS->ELEMENTS TEST. 
* navigate from «CONTEXT? to «TEST- via lead selection 
LO ND TEST = WD CONTEXT->PATH GET NODE( PATH = ZTEST FORM.TEST' ). 
* (TODO compute values 
SELECT * FROM ZZTEST V INTO CORRESPONDING FIELDS OF TABLE LT TEST 
WHERE ZZCLASS = LS ZTEST FORM-CLASS 
AND ZZYEAR =LS ZTEST FORM-YEAR. 


LO ND TEST->BIND TABLE( NEW ITEMS -LT TEST SET INITIAL ELEMENTS = 
ABAP TRUE ). 
ENDMETHOD. 


3) 在 ABAP 工作 台中 的 编辑 界面 创建 Web Dynpro Application, WA] 5-12 所 示 。 


ko 


[c Create Web Dynpro application 


Application zwd adobe form 
Description 成 绩 信 息 检 索 
— 
3 
5712 


4) 在 ABAP 工作 台中 的 编辑 界面 中 运行 Web Dynpro Application。 测 试 结果 如 图 5-13 所 示 。 


成 绩 信息 

班级 :|IA B 

学 年 :|2009 |Æ] 
BasneRn[obsigu 1 
| 8 y im |Ë Z =s d vr 


Hle] el 


» 
^ 
TE Pee mza [us [rk E 
por — |mee — (o — — je j j o | 
we we — qe Ds  w —— pn — | 
pw ae jq j p — [9 | 
m pm p Rp s F | a 
|i4 4[ svn JP n|o @ [|(ü) = 
5-13 


5.3.2 TE Web Dynpro 应 用 中 新 建 Adobe Forms 


1) 在 ABAP 工作 台中 的 编辑 界面 创建 Web Dynpro 组 件 。 
选中 “Web Dynpro Comp./Intf.”, 在 相应 的 文本 框 中 输入 程序 的 名 称 ， 如 图 5-14 所 示 。 


Web Dynpro Comp. / Intf. | 


EZWD. ADOBE INTERACTIVE| EA" 
35 +e] (RET Ja 


5-14 


创建 Web Dynpro 组 件 如 图 5-15 所 示 。 


[E Web Dynpro: Component / Create Interface 

Name | ZWD ADOBE INTERACTIVE | 
Description | 个 人 信息 查询 | 
Tvpe (e Web Dynpro Component 


web Dynpro Component Interface 


Window Name W ADOBE INTERACTIVE | 


View Mame 
+ 2] 


5-15 
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编辑 Web Dynpro 组 件 如 图 5-16 所 示 。 


Object Name Description. 
- dj ZWD ADOBE INTERACTIVE ”| 个 人 信息 查询 
4 COMPONENTCONTROLLER | 个 人 信息 查询 ---- 组 件 控制 器 
| Y da Component Interface | o 2 í í í í í 
* 4E INTERFACECONTROLLER [+T A fE B Erttg-— SH PETERS 
- l'interface Views | 
: EJ. ADOBE INTERACTIT-A.T& RE- 


C3 Views lie | 
* ER v MAIN | 个 人 信息 查询 ---- 视 图 
- [Ë] Windows ECT SS ws s. 
: LIW ADOBE INTERACTIVE 个 人 信息 查询 -… 窗 体 
5-16 


2) 在 ABAP 工作 台中 的 编辑 界面 编辑 Web Dynpro 视图 。 
选中 左 侧 树 形 菜 单 中 的 视图 V MAIN, F% “Context” WF, AJE Context 及 其 属性 
如 图 5-17 所 示 。 


s Fo wary, C C C C C C U] ; 
,Miew jV. MAIN Inactive 


. Properties Layout Inbound Plugs Outbound Plugs Attributes Actions Methods 


Context V. MAIN | 


v 


- Context COMPONENTCONTROLLER 
NODE ADOBE * © CONTEXT 


Y [5] NODE STUDENT 

* B ZZNUMBER 
* "i ZzNAME 
* "i5 ZZSEX 
* "i ZzFNAME 
* "i ZzMNAME 
* B ZZMOBILE 
* P ZZADDR 
* b ZZNOTE 

* $ PDFSOURCE 
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节点 NODE ADOBE 设 定 如 图 5-18 所 示 。 


LẸ Change Node 


Node Name [NODE ADOBE 


Interface Node No v 
Input Element (Ext. ) No v 


Dictionary structure 


Cardinality mi v| 

Selection 01 v] 

Init. Lead Selection Yes v 

Singleton No v 

Supply Function [| S] 

Mapping Path K. 


YY Add Attribute from Structure |[%] 
5-18 


节点 NODE STUDENT 设 定 如 图 5-19 所 示 。 


[=> Create Mode 


Node Marne NODE STUDENT | 


Interface Made Ma T 
Input Element (Ext. ) Ma * 


Dictionary structure 'ZMNUMEER T | 


Cardinality | 1..1 r | 
Selection | 0.1 ka | 


Init. Lead Selection Tes - 


Singleton Ma T 


Supply Function 


5-19 


属性 PDFSOURCE 设 定 如 网 5-20 所 示 。 


[c Create Attribute x 
Attribute Mame |PDFSOURCE 

Type assignment Type — inii 

Type |XSTRING ~ g 

Read-only No 到 


Default Value L | 
Input Help Made Automatic - 
Ermittelte Wertehilfe | | 
Type of Input Help | | 


YY Additional Attribute ||]. 
5-20 


选中 “Layout” 选 项 卡 ， 创 建 UI 元 素 ， 添 加 按钮 及 Interactive Form 7628, aH Je Aul 
图 5-21 所 示 。 


* [.] CONTEXT. MENUS 
~ C] ROOTUIELEMENTCONT AINER 
Y Ë] GRP. STUDENT 
* T CAPTION [Header] 
* T ZZNUMBER LBL 
* fg ZZNUMBER 
* T ZZNAME LBL 
* [`] ZZNAME 
* = BTN. SEARCH 
~ 站 GRP. STUDENT. FORM 
* T CAPTION 1 [Header] 
N 


3 21 
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布局 设 定 如 图 5-22 所 示 。 


ERG Bir 
学 生 学 号 : [v MAINNODE ADOBE Nd] v. MAIN.NODE .4DOBE.NODE, STUDENT.ZZNAME 
学 上 生 以 息 表单 


InteractiveForm: IAF STUDEHT 


5-22 


其 中 查询 条 件 部 分 UI 元 素 绑 定 如 图 5-23 所 示 。 


[c Create Context Binding for Table "GRP_STUDENT" 


Context Node V MAIN. NODE ADOEE. NODE STUDENT És context | 
Standard Cell Editor InputField - 

Standard Property value - 

Context Attribute (Cell Editor of Table Column | Binding Name of Property to Be Bound 
ZZNUMBER InputField š 四 value ti] 
ZZMAME TextView ü 四 | tt B 
ZZSEX InputField B [] value z 
ZZFNAME InputField a g value ti] 
ZZMNAME InputField ns] C) value ti] 
ZZMOBILE InputField z [] "value zl 
ZZADDR InputField š J value z 
ZZNOTE InputField š C value ti] 


3-29 


2J TH S nau 5-24 所 示 。 


[E Create Action 


Component ZWD ADOBE INTERACTIVE | 
View V MAIN : 


Action SEARCH 
n 3 
Description 查询 人 人 信息 00 í f í í í í í í í í í í í í í í í í í | 


Select an outbound plug or enter an 


outbound plug for leaving the view 
by selecting the pushbutton 
Outbound Plug 


EIS 
5-24 


动作 对 应 处 理 程序 编辑 如 下 : 
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METHOD ONACTIONSEARCH . 


* Context £F fl ab ig 
DATA LO ND NODE STUDENT TYPE REF TOIF WD CONTEXT NODE. 


DATA LO EL NODE STUDENT TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LS NODE STUDENT TYPE WD THIS--ELEMENT NODE STUDENT. 
DATA LV ZZNUMBER TYPE WD THIS--ELEMENT NODE STUDENT-ZZNUMBER. 


* navigate from «CONTEXT?» to «NODE STUDENT?- via lead selection 
LO ND NODE STUDENT = WD CONTEXT--PATH GET NODE( PATH = NODE ADOBE. 
NODE STUDENT ). 
* (QTODO handle non existant child 
* [Flo nd node student IS INITIAL. 
* ENDIF. 


* get element via lead selection 

LO EL NODE STUDENT - LO ND NODE STUDENT->GET ELEMENTY( ). 
* (QTODO handle not set lead selection 

IFLO EL NODE STUDENT IS INITIAL. 

ENDIF. 


* WIPRA 
LO EL NODE STUDENT->GET ATTRIBUTE( 
EXPORTING 
NAME = `ZZNUMBER` 
IMPORTING 
VALUE - LV. ZZNUMBER ). 


* navigate from «CONTEXT» to «NODE STUDENT?" via lead selection 
LO ND NODE STUDENT = WD CONTEXT-—PATH GET NODE( PATH = NODE ADOBE.NODE ` 
STUDENT). 
* @TODO handle non existant child 
* IF lo nd node student IS INITIAL. 
* ENDIF. 


* get element via lead selection 
LO EL NODE STUDENT = LO ND NODE STUDENT->GET ELEMENTN( ). 


* (TODO handle not set lead selection 
IFLO EL NODE STUDENT IS INITIAL. 
ENDIF. 


* IET IA fei 
SELECT SINGLE * FROM ZMNUMBER T 
INTO CORRESPONDING FIELDS OF LS NODE STUDENT 
WHERE ZZNUMBER - LV ZZNUMBER . 


* Context Il fH 
LO EL NODE STUDENT->SET STATIC ATTRIBUTES( 


STATIC ATTRIBUTES = LS NODE STUDENT ). 
ENDMETHOD. 


3) 在 ABAP 工作 台中 的 编辑 界面 编辑 Adobe Form. 
Interactive Form 元 对 属性 设 定 如 图 5-25 PTR. 
双击 templateSource 属性 ， 创 建 Form 并 设 定 接口 如 图 5-26 所 示 。 


Property Value Bin... 
Properties (InteractiveForrr | 
ID IAF STUDENT 
additional&rchives 
contextMenuBe Inherit l 
contextMenuId 
dataSource V MAIN.NODE ADOBE | & - 
displayTvpe native Ë [ J 
enabled = mum 
height [. ] 
pdfsource V MAIN.PDFSOURCE 
readonly = == [E" Specify Form Interface 
templateSource | ZTEST. INTERACTIVE 
tooltip [ J Specified Farm Object Does Mot Exist 
visible Visible afl jJ To Create the Object, You Must First Specify a 
width 600px mE 
Events Form Interface 
onSubmit ü FRP 

avout Data (FlowData Interface Name 'ZTEST INTERACTIVE INT | 
cellDesign padless t] 
vGutter None El 

图 5-25 图 5-26 


单 击 图 5-26 中 的 区 Context 


[E CONTEXT. VIEWER 


Choose Context Element 
Context v MAIN 


~ (O CONTEXT 
> [5| 
Y [$] NODE STUDENT 

* $ ZZNUMBER 
* "E ZZNAME 
° H zzsE 
。 $ ZZFNAME 
* ®B ZZMNAME 
* $ ZzMOBILE 
. "b ZZADDR 
* b ZZNOTE 

* "la PDFSOURC 


vix) 
图 5-27 
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单 击 吧 按钮 保存 当前 页 面 ， 编 辑 Adobe Form 属性 如 图 5-28 所 示 。 


表格 ZTEST. INTERACTIVE IERI 
描述 个 人 信息 表单 ] 
该 表格 使 用 基于 XML 方案 的 接口 。 

格式 类 型 ZCI 格式 NEZ 

接口 [ZTEST INTERACTIVE INT | 

Eingangsverarb. | 

创建 者 ECUSER | 更 改 者 [ECUSER | 
日 期 2013/02/21 日 期 |2013702721| 
时 间 19:39:55 时 间 epulo abe el 

包 ZWD TRAINING 

原始 语言 [zH] 

5-28 


编辑 Adobe Form 布局 如 图 5-29 所 示 。 
在 Form 编辑 页 面 上 ， 按 照 以 下 路 径 将 Web 屏幕 脚本 插入 Form， 如 图 5-30 所 示 。 


实用 程序 山 ) 


显示 对 和 象 清单 (OQ) Ctri-Shift+F5 
工作 清单 L) b 
显示 导航 窗口 (N) ”Ctrl+Shift+F4 
上 载 表 格 ..…...(F) 
"PERS... (M) 
ESCESTL..(T) 
下 载 子 树 ..…...(I) 

— MA web RENE 000 


版 本 以) > 


<] 5-29 5-30 


编辑 FormCalc 脚本 如 图 5-31 所 示 。 


表格 ZTEST_INTERACTIVE | 有 效 的 
尾 性 


Edit 


| 


View Insert Table Layout Tools Palettes Help 


=Z = w s| s Z| Úi Z www ow NON U 


o e [Em L] [Ee xe. 局 uw 4 
IB 7 U| = = = = 


Son: [a — s| @| fm ER Language: una 


NODE ADOBE.fZsubform[0].Tablei.Row3.ZZSEX::initialize 
if ($record.NODE STUDENT.ZZSEX.value == "M") then 
NODE ADOBE.fZgsubform[0].Tableli.Row3.ZZSEX.value.ftext = "B "s 
elseif ($record.NODE STUDENT.ZZSEX.value == "gy") then 

NODE ADOBE.f£subform[0].Tablei.Row3.ZZSEX.value.ftext = "i"; 
endif 


(FormCalc, client) 


5-3] 
编辑 Adobe Form, All 5-32 所 示 。 
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[c Create Web Dynpro application 
zwüd adobe interactive 


Application 
下 3 
Description QUT r r L U U | 
L - 


5-32 


4) 在 ABAP 工作 台中 的 编辑 界面 测试 Adobe Form, n 5-33 所 示 。 


= FEE B Pru 

学 生 学 号 : [00002 ORs 查询 | 

FEREARE 

8 = = e ñ iO D sm ag i @,- nes Tet 
Pu e B DI Dt 


个 人 信息 表单 


S3 
1398764X X X X E 


北京 鲁迅 路 129 号 


修改 后 
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要 为 数据 视图 的 表单 提供 新 的 元 素 ， 首 移 需 要 增强 相关 的 Web Dynpro 的 Contexts HJ UJ 
通过 Web Dynpro IRE EZS Context 编辑 器 进行 编辑 ， 如 图 5-34 所 示 。 通 过 双击 视图 上 
的 InteractiveForm UI 元 素 可 以 转 到 表单 生成 器 。 此 时 XML 架构 连同 表单 生成 器 中 的 数据 视图 
会 日 动 调整 ， 如 图 5-35 所 示 。 


界面 [ZTEST INTERFACE INT | 有 效 的 
尾 性 
=] 
`Z | 
wa <?xml versionz"1.0" encoding="utf-8" ?> 3 


B xmlns:xsdz"http:/ /vwww.w3.org/2001/XMLSchema" 


z ZTEST_INTERFACE_INT 
xmlns: xfaz"http:/ /www.xfa.org/schema/xfa-template/2.1/" 


~ O 表格 接口 
* [E] 导入 xmlns: xfadataz"http:/ /wwiw.xfa.org/schema/xfa-data/1.0/" 
BER xmlns:xhtmlz"http:/ /vwviw .w3.0rg/1999/xhtml"- — 
- B A <xsd:import namespace="http:/ /wwiw.xfa.org/schema/xfa-data/1.0/" /> 
- <xsd:element name="NODE_ADOBE" version="2" fromWDContext="true"> 


- «xsd:sequencez 


i > C4 XML 方案 
435 —.— — | 。 - <"sdcomplexType> 
- <xsd:element name-z"NODE STUDENT" minOccurs-"1" 


[t] ZzFNAME 
i E] ZZOMMAME E maxOccurs="1"> 
: X : - «xsd:complexType- 
i E] ZZPMOBILE EN Í - <xsd:sequence> 
i | - «xsd:element namez"ZZNUMBER" type-"ZZNUMBER E"- 
i [E | ZZADDE ixi - «xsd:annotationz 
: 4 : <xsd'documentation> 学 生 番 号 
E] ZZÉNOTE E «/sd:documentationz 
<zxsd':annotation> 


«</xsd: element> 
- <xsd:element namez"ZZNAME" type="ZZNAME_E"> 
- «xsd:annotation- 
«xsd:documentation2XE 4 «/«sd: documentationz 
z/«xsd:annotationz 
</xsd: element> 
- <xsd:element name="ZZSEX" type="ZZSEX_E"> 


|< 


5-35 


5-34 
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ME: 如 果 使 用 templateSource 整合 现 有 的 表单 和 它 的 接口 不 是 XML 模式， 在 其 后 就 不 可 
以 添加 任何 多 余数 据 字 段 。 


5.4 插入 已 有 PIERE (MIME 对 象 ) 


存储 在 系统 中 的 MIME 库 中 的 MIME 类 型 为 application/pdf 的 MIME 对 象 ， 它 可 以 集成 
到 Web Dynpro 应 用 程序 中 。 

(1) 前 提 

要 存储 表单 到 MIME 库 中 ， 最 简单 的 方法 是 通过 以 下 路 径 导 入 表单 到 Web Dynpro 组 件 
中 ， 如 图 5-36 所 示 。 


Change View 
Display k Window 
Create/ Change Configuration | Custom Controller 
Check b Service Call | 
Copy... Web Dynpro Application | 
Basis I EIU 
Delete 
Where-LIsed List 
Other Functions i 
lk] 5-36 


导入 的 PDF 会 在 组 件 的 对 象 列表 中 的 MIMEs 下 列 出 ， 如 图 5-37 所 示 。 


"7 g^ HYG ADOBE 
a2 COMPONENTCONTROLLER 
Ë s Component Interface 
D E views 
D M windows 
v A MMES 


[E popuppdf 


[mmc sss 


Ë EH Web Dynpro Applications 
图 5-37 


(2) 操作 (Procedure) 

1) 在 Web Dynpro Vti Er garhi, GUEE— T TULIP UE. EMA Context H, A 
建 类 型 为 XSTRING 的 Context 属性 用 于 绑 定 InteractiveForm UI 元 素 的 pdfSource 属性 。 在 视 
图 布局 设计 絮 里 ， 拖 动 InteractiveForm UI 元 系 到 布局 中 并 做 相关 属性 绑 定 。 

2) 转 到 视图 Methods ER VA, mf ER WDDOINIT 如 下 : 


METHOD WDDOINIT . 
DATA: 
ELEM CONTEXT TYPE REF TOIF WD CONTEXT ELEMENT, 


SIRU CONTEXT TYPE IF VIEW=>ELEMENT CONTEXT, 
ITEM STATIC PDF LIKE STRU CONTEXT-STATIC PDF. 
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get element via lead selection 
ELEM CONTEXT = WD CONTEXT--GET ELEMENTN( ). 
DATA:MR TYPE REF TO IF MR API, 
LURL TYPE STRING. 


get name of component 

DATA: L COMPONENT TYPE REF TO IF WD COMPONENT, 
L COMPONENT INFO TYPE REF TO IF WD RR COMPONENT, 
L NAME TYPE STRING. 


L COMPONENT = WD COMP CONTROLLER-WD GET API(). 
L COMPONENT INFO = L COMPONENT--GET COMPONENT INFO ). 
L NAME =L COMPONENT INFO--GET NAME(). 


get mime object 


MR = CL MIME REPOSITORY API—GET API(). 
CALL METHOD CL WD UTILITIES—-CONSTRUCT WD URL( EXPORTING APPLICATION - 
NAME -L NAME 
IMPORTING OUT LOCAL URL -LURL ). 
CONCATENATE LURL "' 'popup.pdf INTO LURL. 


MR--GET( EXPORTING I URL - LURL 
IMPORTING E CONTENT = ITEM STATIC PDF ). 
ELEM CONTEXT-SET ATTRIBUTE( 
EXPORTING 
NAME = ‘STATIC PDF 
VALUE = ITEM STATIC PDF ). 


ENDMETHOD. 


在 该 例子 中 只 需要 指定 MIME 对 象 的 名 称 : popup.pdf. 
还 可 以 通过 手动 插入 路 径 接 收 MIME XJ: 


METHOD WDDOINIT . 
DATA:MR TYPE REF TO IF MR API, 
CONTENT TYPE XSTRING. 


MR = CL MIME REPOSITORY API=>GET API( ). 
MR->GET( EXPORTING I URL  -'sap/bc/webdynpro/sap/zhvg adobe2/popup.pdf 
IMPORTING E CONTENT = CONTENT ). 


* — set mime object 
wd context->set attribute( name = PDFSOURCE' value = content ). 
ENDMETHOD. 


Ve 
OH 


3) 保存 、 纺 详 、 执 行 ， 碍 看 运行 结束。 
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55 ”表单 集成 中 的 数字 签名 Digital Signatures 


编辑 表格 时 ， 其 内 容 安 全 是 关键 。 使 用 数字 签名 是 一 个 好 方法 ， 使 原始 的 表单 的 真 伪 得 
以 验证 。 

(1) BT 

1) ADS 连接 。 对 于 签名 ， 你 需要 通过 SSL 或 HTTPS 的 一 个 安全 连接 。 对 于 这 一 点 ， 系 
统 需要 一 个 HTTP 类 型 的 RFC 连接 , 该 RFC 连接 到 外 部 服务 器 的 ADS。 外 部 ADS 服务 必须 
是 以 JPEE 引 敬 服务 器 的 服务 。 

2) 附 有 签名 栏 的 文档 。 设 置 和 检查 签名 ， 表单 必 须 有 一 个 签名 栏 。 可 以 使 用 表单 生成 器 
在 布局 中 插入 签名 栏 GRAVIS: SFP). 

签名 是 人 否 是 服务 需 疹 或 客户 端 没有 任何 区 别 。 

(2) 在 表单 上 签字 

1) 创建 一 个 带 有 数字 签名 的 表单 ， 在 表单 上 进行 数字 签名 时 ， 单 击 表 单 上 的 签名 栏 ， 如 


图 5-38 所 示 。 
Signature: | Ë 
[Signature: (click to sign)| (click to sign) 


图 5-38 
2) 确认 随后 的 提示 ， 将 签名 信息 输入 签名 字段 中 ， 如 图 5-39 R. zn: 


Digitally signed by D021198 


Signature: 21 1 98 DN: cn-D021198, c-DE, o-SAP-AG 


图 5-39 
(3) 检查 签名 
通过 插入 表单 的 Send 按 包 验 证 签名 的 有 效 性 检查 。 访 按钮 用 于 后 台 则 签名 的 发 六。 
接口 IF FP. PDF OBJECT 的 方法 GET. SIGNATURES 用 于 此 目的 。 


96 j Adobe 库 中 的 Ul > 


OO -x 
Object Library x 


在 Web Dynpro ABAP 应 用 程序 的 Adobe 设计 表单 开发 时 ， 进 入 mestre is 
到 表单 设计 器 的 “布局 ”选项 卡 中 ,利用 这 些 UI 元 素 编辑 表单 。 根 据 e 


TT ` ` ` "-— : [^| Check Box š 
表单 集成 的 类 型 ， 以 下 库 中 的 元 素 可 用 于 Web Dynpro ABAP 中 ， 如 2 


图 5-40 所 示 。 edhe Pen 
1. ZCI = 单 a Field 
TE Drop-down List 
如 果 在 表单 生成 器 中 选择 了 ZCI 布局 作为 布局 类 型 属性 ， 则 作为 Eese 


-个 基于 ZCI 表单 的 开发 者 , 可 以 使 用 Web Dynpro 原生 库 。 目前 Web — me 


项 Imaoge Field 
Dynpro ABAP 环境 下 所 支持 的 Adobe 的 UI 元 素 如 下 : u " 3 
(1) Send 按钮 (SubmitToSAP) i 
使 用 Web Dynpro 表单 的 UI JGZ SubmitToSAP， 发 送 一 个 PDF fi 5-40 
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表单 的 输入 数据 到 SAP 后 合 系统 。 与 Web Dynpro 的 输入 数据 同步 ， 绑 定 到 InteractiveForm 
HJ Web Dynpro 的 Context WA GKE Eiir H ape SITE DataSource 的 节点 属性 ) 会 目 
动 更 新 。Web Dynpro UI 元 素 InteractiveForm 的 动作 onsubmit 也 被 触发 。 

(2) EnumeratedDropDownList 和 EnumeratedDropDownListNoSelect 

在 表单 上 这 两 个 UI 元 素 用 于 可 检索 对 象 ， 在 Adobe 设计 器 中 使 用 拖 放 Web Dynpro 
库 的 UI 元 素 编 辑 表单 。 两 个 元 素 之 间 的 差异 是 ， 如 采 在 所 有 的 数据 部 分 中 没有 条 目 或 当 
前 选择 列表 没有 相关 条 目 ， 则 EnumeratedDropDownListNoSelect 不 会 目 动 选择 一 个 值 。 
EnumeratedDropDownList 会 自动 检索 选择 列表 中 的 第 一 项 。 

(3) 操作 

1) 将 Adobe 的 UI 元素 拖 放 人 至 模板 ， 并 把 它 绑 定 到 数据 视图 中 的 Context. 

2) 改变 元 素 值 绑 定 。 


© 选择 Element Values。 在 下 面 弹出 的 Objects 的 下 方 会 出 现 组 标题 Binding: 


$ record.sap-vhlist.REPLACE THIS.item[*] 


e SOM 的 数据 绑 定 表达 式 蔡 换 REPLACE_THIS。 

从 Objects 六 蛙 中 可 以 得 到 这 个 值 。 该 值 以 $record 开头 ， 如 绑 定 万 点 Node.DVH3. 

正确 的 值 的 示例 : $ record.sap-vhlist.Node\.DVH3.item[*] 

it: EnumeratedDropDownList 的 值 采 取 从 Web Dynpro 属性 VALUE SET Æt. wA 
该 类 型 的 属性 是 DDIC (ABAP 字典 ) 和 定义 域 的 国定 值 ， 则 这 些 值 会 被 显示 出 来 。 也 可 以 对 
VALUE SET 编程 ， 以 填补 在 运行 时 的 值 。 

(4) 输入 帮助 EN E 

Adobe 的 UI 元素 输入 帮助 , 使 得 它 可 以 用 帮助 的 形式 来 
调用 输入 ， 如 图 5-41 所 示 。 id 

需要 注意 有 的 是 ，XFO 编码 的 输入 帮助 必须 调整 。 输 入 绑 定 的 属性 字段 的 名 称 〈 在 本 例 中 
是 CARRID )。 

1) 初始 化 时 赋值 : 


var fieldName = "**IHNSERT NAME HERE**"; 


2) 输入 时 赋值 ， 如 图 5-42 所 示 。 
Emm: | AS 


var fieldName = "CARRID"; 


7 — AS 
国有 jx || Body Pages SUMaster Pages x Xv PDF Preview x x 
EN Data View `S m Ú [ E E T 
399 CITYFROM al 
9! COUNTRYFR g 
df! COUNTRYTO 
y cirvro 
C valueHelpi 
CJ valueHelp2 1 
C valueHelp3 
CJ valueHelpá 
C valueHelpS 


KE, Adobe 的 UI 元素 的 输入 帮助 是 连接 到 Web Dynpro ABAP 输入 帮助 的 。 
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2. ACF 表单 

ACF 的 基础 上 开发 的 表单 是 基于 Web Dynpro ActiveXlibrary《〈 请 参阅 关于 PDF 的 打印 表 
格 的 文档 ) BU. 

目前 Web Dynpro ABAP 环境 下 支持 的 元 素 : Send. 

使 用 Web Dynpro 表单 UI JGZ Send, 是 将 PDF 表单 中 输入 的 数据 发 送 到 用 于 存储 的 SAP 
后 合 系统 。UI 元 素 也 提供 了 一 个 目 动 生成 的 事件 。 


5.7 交互 式 表单 应 用 


有 很 多 原因 , Web Dynpro MHIE m hR. 大 多 数 航 入 式 的 表 蛙 用 于 打印 和 存档 ， 
因此 不 提供 互动 式 的 表单 。 但 Web Dynpro 框架 仍然 可 以 使 用 内 骸 的 PDF 表单 用 于 交互 。 使 
用 PDF 作为 Web Dynpro 应 用 程序 输入 的 模板 可 能 是 特别 有 用 的 ， 尤 其 是 当 用 户 熟 悉 表 单 的 
外 观 及 内 容 的 情况 下 ， 这 种 表单 在 系统 中 是 非常 有 用 的 。 

在 系统 的 默认 设 定 中 , WR UI 元 素 的 类 型 InteractiveForm 是 非 交 互 式 的 , 那 就 是 enabled 
属性 的 复 选 框 未 选中 。 如 果 要 使 用 交互 报表 ， 则 必须 选中 enabled 属性 复 选 框 。 

注 : 如 果 希 望 应 用 程序 使 用 交互 式 报 表 , 则 需要 选中 该 复 选 框 ， 即 表 示 该 表单 作为 Active 
Components Framework ( ACF) 用 于 呈现 在 客户 端 (一 般 用 户 浏览 器 ) 中 ， 因 此 ACF 26520 3 3 
到 客户 端 。 通常 情况 下 相关 的 应 用 程序 第 一 次 被 调用 时 ，ACF 会 从 SAP NetWeaver AS 中 集中 
安 蒜 到 客户 浏览 器 中 。 然 而 ， 一 个 用 户 可 能 没有 足够 的 ACF-CAB 文件 安装 在 本 地 的 授权 也 
是 可 能 的 。 在 这 种 情况 下 ， 用 户 不 能 显示 表单 。 如 果 表 单 enabled 属性 复 选 框 没有 被 选中 ， 则 
不 需要 进行 ACF Xn. 


9.8 基于 ABAP 数据 字典 接口 表单 


Birds T XML 的 接口 进行 了 介绍 ， 与 基于 ABAP 字典 接 口 的 表单 的 建立 在 集成 过 程 
中 是 相同 的 。 然 而 ， 这 样 的 接口 不 容易 链接 到 Web Dynpro 组 件 的 Context 中 。Web Dynpro 内 
创建 的 所 有 表单 不 会 目 动 配备 一 个 基于 XML 的 接口 。 然 而 ， 在 某 些 情况 下 ，Web Dynpro 的 
Context 是 有 必要 集成 到 Web Dynpro 应 用 程序 中 的 一 个 基于 功能 模块 接口 的 表单 的 。Web 
Dynpro 运行 时 ， 原 则 上 使 得 它 可 以 在 Web Dynpro 应 用 程序 内 显示 或 打印 这 样 一 种 表单 。 在 
某 些 特殊 情况 下 ， 它 甚至 有 可 能 在 交互 模式 下 运行 ， 该 类 型 也 是 一 种 表单 的 集成 形式 。 

注 : 一 个 基于 功能 模块 接口 的 表单 只 能 用 PDF 打印 。 

UI 元 素 InteractiveForm 也 可 以 限制 输入 。 由 于 用 户 输入 的 值 都 没有 传递 到 各 目的 属性 。 
表单 显示 在 改变 模式 下 ， 用 户 完 成 输入 ， 它 被 作为 一 个 整体 存储 在 Context 属性 中 ,该 属性 映 
35 iS TE pdfSource 上 。 这 对 打印 或 归档 表单 是 特别 有 用 的 。 在 这 种 情况 下 ， 输 入 的 验证 在 本 
框架 下 还 没有 提供 。 

注 : 一 旦 窗 体 设 置 为 输入 启用 ， 该 属性 将 被 保留 。 它 不 能 再 被 重 置 为 一 个 纯粹 的 显示 模式 、。 

UI 元 素 InteractiveForm 的 接口 类 中 包含 方法 SET LEGACY EDITING ENABLED 可 以 
动态 设置 输入 的 局 用 ， 方 法 可 以 传递 一 个 布尔 参数 用 于 设置 输入 。 当 表单 被 设置 如 下 时 输入 

88 


功能 被 局 用 。 

e SAHEN X- 

€ UI JCA InteractiveForm 的 enabled 属性 被 选择 。 

e JETE pdfSource 被 绑 定 到 一 个 类 型 为 XSTRING 的 Context 属性 上 。 

e 属性 dataSource 被 绑 定 到 一 个 与 表单 Context ZH Context 属性 上 。 

表单 使 用 Context 在 InteractiveForm 和 Web Dynpro 的 Context 之 间 交 换 数 据 。 如 果 表 单 
是 基于 一 个 ABAP 数据 字典 接口 的 ， 则 数据 从 接口 传递 到 表单 Context. 程序 员 可 以 选择 更 改 
属性 名 称 。 但 在 这 种 情况 下 ， 必 须 使 用 指定 的 属性 名 。 

下 面 的 代码 户 段 显示 了 如 何 配置 为 输入 的 表单 : 


METHOD WDDOMODIFYVIEW. 
DATA:LR INTERACTIVE FORM TYPE REF TO CL WD INTERACTIVE FORM, 
LR METHOD HANDLER TYPE REF TO IF WD IACTIVE FORM METHOD HNDL. 
CHECK FIRST TIME = ABAP TRUE. 
LR INTERACTIVE FORM ?= VIEW--GET ELEMENT('INTERACTIVE FORM 1) 
LR METHOD HANDLER ?- LR INTERACTIVE FORM-> METHOD HANDLER. 
LR METHOD HANDLER->SET LEGACY EDITING ENABLED( ABAP TRUE ). 


ENDMETHOD. "WDDOMODIFYVIEW 


5.9 ”隐藏 Adobe Toolbar 


HJ PJ e ESE, Adobe Reader 的 工具 栏 。 在 默认 设置 中 ， 该 工具 栏 是 显示 的 ， 如 图 5-43 
所 示 。 


$) jo 


Dies ist em PDF-Dokument. Es dient dem Test des Anzeige-Szenario: 


This is a PDF document. Its purpose is to test the display-scenario 


图 5-43 


可 以 使 用 UI 元 素 的 接口 InteractiveForm IF WD IACTIVE FORM METHOD HNDL 的 
方法 SET_HIDE TOOLBARS 隐藏 工具 栏 ， 如 图 5-44 所 示 。 


Ir method handler->set hide toolbars( abap true ); 


Dies ist em PDF-Dokument. Es dient dem Test des Anzeige-Szenario: 


This 15 a PDF document. Its purpose is to test the display-5cenario 


图 5-44 
用 户 可 以 通过 选择 应 用 程序 中 的 功能 键 F8 来 隐藏 〈 或 显示 ) 工具 栏 。 
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^B 63€ ALV fr Web Dynpro ABAP 中 的 应 用 


SAP List Viewer (ALV) 是 一 种 灵活 的 工具 ， 用 于 显示 列表 和 表 结 构 。 作 为 标准 功能 ， 
该 工具 提供 了 常见 的 列表 操作 ， 可 以 提 融 日 定义 选项 。 这 允许 用 户 在 比较 大 的 应 用 程序 中 使 
用 ALV. 

对 于 最 终 用 户 来 说 ， 标 准 的 输出 包括 工具 栏 、 标 题 及 输出 表 。 用 户 可 以 通过 使 用 特定 的 
对 话 框 进行 设置 ， 从 而 更 改 列 的 显示 ， 进 行 更 复杂 的 排序 、 汇 总 。 作 为 应 用 程序 开 有 人 员 ， 
在 ALV 输出 时 有 多 种 选项 来 定义 的 外 观 、 功 能 和 运行 时 的 动作 。 

程序 员 还 可 以 使 用 ALV 组 件 。 与 其 他 所 有 预定 义 的 组 件 一 样 ， 可 以 将 ALV 组 件 添 加 到 
自己 的 应 用 程序 组 件 中 。 该 应 用 组 件 可 以 使 用 ALV 组 件 具 有 的 所 有 功能 ， 这 样 应 用 程序 为 用 
户 提供 了 强大 的 工具 来 显示 列表 。 

ALV 组 件 部 分 基于 Web Dynpro 的 UI JCR Table. XERE, WS Table 元 素 的 属性 在 
ALV 组 件 中 是 可 用 的 ， 这 包括 使 用 不 同 的 单元 格 编辑 器、 背景 闫 色 和 尺寸 规格 。 除 此 之 外 ， 
下 面 的 选项 也 是 可 用 : 

e 指定 的 列 包含 在 用 户 的 列 集 ， 用 户 输 出 ALV 时 这 些 都 是 可 见 的 。 

e 可 以 排序 和 过 滤 ALV 输出 的 值 ， 并 执行 计算 。 

e 决定 是 奋 在 那些 沁 围 内 编辑 ALV 输出 。 

e 指定 在 列 的 单元 格 中 显示 何 种 UI 元 系 的 值 。 

e 在 工具 栏 中 提供 UI 元 系 ， 用 户 可 以 执行 特定 的 应 用 程序 的 功能 。 

e 可 以 指定 是 否 及 如 何 处 理 用 户 交 互 的 ALV 输出 。 

e 用 户 可 以 你 存 不 同 显示 的 设置 。 

e 可 以 配置 ALV 输出 的 上 方 和 下 方 的 特殊 区 域 。 


61 在 应 用 程序 中 集成 MY 


1. 目的 

如 果 想 在 应 用 程序 中 使 用 ALV 输出 ， 则 根据 所 需 的 结果 ， 必 须 萤 循 相应 的 步 又 。 下 列 变 
式 列 出 了 最 重要 的 方法 ， 可 以 用 于 调用 ALV: 

D 简单 的 调用 (无 ALV 配置 ): 仪 显示 一 个 ALV 输出 。 不 想 进 行 任何 更 改 。 

2) 简单 的 调用 〈 有 ALV 配置 ): 要 更 改 使 用 应 用 程序 的 标准 输出 。 要 做 到 这 一 点 ， 需 要 
ALV 配置 。 

3) 外 部 视图 的 ALV 输出 (无 ALV 配置 ): ALV 输出 仅仅 是 在 一 个 视图 中 的 许多 元 素 之 一 。 
用 户 不 想 改 变 ALV 输出 ， 并 不 需要 ALV 配置 。 

4) 外 部 视图 的 ALV 输出 (有 ALV WE): ALV 输出 仅仅 是 在 一 个 视图 中 的 许多 元 素 之 
一 。 用 户 要 使 用 应 用 程序 更 改 标准 和 输出。 要 做 到 这 一 点 ， 需 要 ALV 配置 。 
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2. 前 提 

程序 员 必 须根 据 上 面 列 出 的 所 有 变 式 进行 如 下 (ALYV EX) 操作 : 

1) 为 应 用 程序 创建 Web Dynpro 组 件 ， 将 其 保存 激活 。 

2) 创建 一 个 Context TH, EAN 0.. Ne 1% Context 节点 的 结构 (名 称 和 数据 类 型 ) 在 
下 一 步骤 中 ， 连 接 到 该 Context 节点 的 内 部 数据 表 的 结构 及 属性 是 相同 的 。 

3) 将 内 部 数据 表 数 据 绑 定 到 Context 节点 〈 如 使 用 供给 方法 )。 要 做 到 这 一 点 ， 可 以 使 用 
接口 正 WD CONTEXT NODE 中 的 方法 BIND TABLE. 

4) 在 应 用 程序 的 ALV 接口 控制 器 中 提供 的 数据 Context 节点 上 使 用 外 部 数据 映射 (将 创 
建 的 Context 节点 映射 到 ALYV 接口 控制 器 中 提供 的 数据 Context 市 点 )。 

3. 操作 流程 

若 上 面 列 出 的 先决 条 件 都 满足 ， 则 过 程 操 作 取 决 于 所 需 的 结 

(1) WAWA E ALV 配置 ) 

1) 在 应 用 程序 组 件 中 为 ALV 组 件 SALV WD TABLE 定义 一 个 组 件 使 用 。 在 操作 时 ， 
可 以 指定 组 件 使 用 的 名 称 〈 如 MY_ALV )。 

2) 在 应 用 程序 数据 和 ALV 接口 控制 器 提供 的 DATA Context 节点 建立 外 部 Context Bt 

3) 编辑 组 件 的 窗 体 ， 藤 入 ALV 组 件 SALV WD TABLE 的 接口 视图 。 

(2) WAWA CA ALV 配置 ) 

D 在 应 用 程序 组 件 中 为 ALV 组 件 SALV WD TABLE 定义 一 个 组 件 使 用 。 在 操作 时 ， 
可 以 指定 组 件 使 用 的 名 称 〈 如 MY _ALV )。 

在 组 件 控 制 器 中 定义 该 组 件 使 用 。 因 为 需要 进行 ALV 配置 , 所 以 选择 控制 器 访问 变 式 ( 组 
件 接口 )。 

2) 编辑 组 件 的 窗 体 ， 髓 入 ALV 组 件 SALV WD TABLE 的 接口 视图 。 

3) 在 应 用 程序 数据 和 ALV 接口 控制 器 提供 的 DATA Context 节点 建立 外 部 Context 映射 。 

4) ALV 输出 配置 ， 必 须 遵 循 以 下 两 个 额外 的 步 又: 

e 在 组 件 的 控制 器 Ou WDDOINIT) 的 方法 中 实例 化 所 使 用 的 ALV 组 件 。 

e 会 收 到 ALV 配置 模型 和 对 象 模型 ， 以 及 字段 对 象 和 列 对 象 。 

(3) 外 部 视图 的 ALV 输出 (无 ALV 配置 ) 

1) 决定 在 组 件 控制 器 中 或 在 应 用 程序 视图 中 的 Context 下 是 否 需要 Context 节点 。 如 果 
有 必要 ， 则 在 视图 中 创建 适当 的 Context 节点 和 映射 到 它 的 组 件 控制 器 Context 的 节点 。 

2) 在 应 用 程序 组 件 中 为 ALV 组 件 SALV WD TABLE 定义 一 个 组 件 使 用 。 在 操作 时 ， 
可 以 指定 组 件 使 用 的 名 称 (如 MY _ALV)。 也 可 以 在 视图 属性 中 定义 这 个 组 件 的 使 用 。 既 然 
不 需要 ALV 配置 ， 就 不 用 选择 控制 器 访问 的 变 式 ( 没 有 组 件 接口 )。 

3) 在 应 用 程序 数据 和 ALV 接口 控制 鼎 提 供 的 DATA Context 市 点 建立 外 部 Context 映射 。 

4) 在 视图 布局 中 所 需 的 位 置 创建 UI 元 素 ViewContainerUIElement。 

5) 编辑 组 件 的 窗 体 ， 髓 入 以 创建 视图 ， 在 视图 的 UI JC% ViewContainerUIElement F fx 
A ALV 组 件 SALY WD TABLE 的 接口 视图 。 

(4) 外 部 视图 的 ALV 输出 (有 ALV 配置 ) 

1) 决定 在 组 件 控制 器 中 或 在 应 用 程序 视图 中 的 Context 下 是 否 需 要 Context 节点 。 如 果 
有 必要 ， 则 在 视图 中 创建 适当 的 Context 节点 和 映射 到 它 的 组 件 控制 器 Context 的 节点 。 
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2) 在 应 用 程序 组 件 中 为 ALV 组 件 SALV WD TABLE 定义 一 个 组 件 使 用 。 在 操作 时 ， 
可 以 指定 组 件 使 用 的 名 称 Cl MY _ALV)。 也 可 以 在 视图 属性 中 定义 这 个 组 件 的 使 用 。 既 然 
需要 ALV 配置 ， 就 需要 选择 控制 器 访问 的 变 式 〈 组 件 接口 )。 

3) 在 视图 布局 中 所 需 的 位 置 创 建 UI 元 素 ViewContainerUIElement。 

4) 编辑 组 件 的 窗 体 ， 骸 入 以 创建 视图 ， 在 视图 的 UI 元 素 ViewContainerUIElement F HX 
A ALV 组 件 SALY WD TABLE 的 接口 视图 。 

5) ALV 输出 配置 ， 必 须 遵 循 以 下 两 个 额外 的 步骤 : 

e 在 组 件 的 控制 器 〈 如 WDDOINIT) 的 方法 中 实例 化 所 使 用 的 ALV 组 件 。 

e 会 收 到 ALV 配置 模型 和 对 象 模 型 ， 以 及 字段 对 象 和 列 对 象 。 


6.1.1 组 件 使 用 定义 


在 应 用 程序 中 ， 要 使 用 组 件 SALV_WD TABLE 进行 ALV 输 出 ， 可 以 将 这 种 ALV 组 件 作 为 
外 部 组 件 集成 到 Web Dynpro 组 件 。 要 做 到 这 一 点 ， 可 以 定义 组 件 的 使 用 。 


注 : 如 果 想 显示 多 个 不 同 ALV 输出 ， 则 各 自 不 同 的 组 件 使 用 唯一 的 名 称 可 作为 这 些 输出 
之 间 的 区 分 。 


如 何 定 义 组 件 的 使 用 取决 于 想 如 何 使 用 ALV 组 件 。 

e 如 果 在 屏幕 上 ALV 的 输出 是 唯一 的 元 素 ， 那 么 ALV 组 件 的 使 用 只 要 在 应 用 程序 组 件 
中 定义 〈 在 “组 件 编辑 器 ”层次 结构 中 顶级 节点 的 组 件 ) 即 可 。 这 是 最 简单 的 一 种 情 
况 。ALV 显示 出 来 后 才 可 以 配置 输出 。 

e 如 果 在 屏幕 上 ALV 输出 是 唯一 的 元 素 〈 同 上 )， 但 想 改 变 外 观 、 功 能 或 运行 时 的 
动作 ， 则 在 应 用 程序 的 组 件 控 制 器 的 属性 中 指定 组 件 的 使 用 。 选 择 控制 器 访问 

e 如 果 要 插入 ALV 输出 到 一 个 复杂 的 布局 中 , 则 在 应 用 程序 的 视图 属性 中 , 定义 组 件 使 
用 ， 该 视图 作为 ALV 输出 要 显示 的 视图 (而 不 是 组 件 控制 器 )。 

根据 是 否 要 使 用 标准 的 ALV 输出 显示 , 或 是 否 要 改变 它 ， 选 择 无 控制 器 访问 或 控制 右 访 

问 的 变 式 。 


6.1.2 ”供应 数据 


要 提供 想 要 的 数据 用 来 ALV 输出 ， 可 以 执行 以 下 3 个 步骤 。 

1) 内 部 数据 表 : 定义 一 个 内 部 表 。 

2) Context B gi: 在 应 用 程序 中 定义 一 个 合适 的 Context 节点 及 其 属性 。 

3) 将 数据 传输 到 ALV 组 件 : 可 以 为 ALV 组 件 定义 Context B ji. 

1. 内 部 数据 表 

内 部 数据 表 中 的 数据 必须 是 局 平 结构 、 可 用 的 。 这 是 唯一 的 先决 条 件 。 做 到 这 一 点 最 简 
持 的 方法 是 使 用 现 有 的 DDIC 结构 。 

2. Context TA 

ALV 组 件 需 要 一 个 Context 节点 用 于 存储 内 部 数据 表 中 的 数据 。 该 Context B ni HA UA 


e IAS 0.. N. 
e 它 仪 包含 属性 没有 子 节 点 : 对 应 于 内 部 数据 表 中 的 每 一 列 ， 需 创建 一 个 相同 名 称 和 数 
据 类 型 的 属性 。 

e 上 所 有 的 属性 都 是 静态 的 ， 不 是 动态 的 。 

如 果 内 部 数据 表 是 基于 一 个 DDIC 结构 ， 则 使 用 其 创建 Context 方 点 及 其 属性 是 最 人 简单 
的 方法 3 

内 部 数据 表 中 的 数据 传输 到 应 用 程序 Context TA, 即 该 节点 到 数据 表 的 连接 。 要 做 到 这 
一 点 ， 使 用 方法 BIND_TABLE， 如 在 控制 器 的 供给 方法 中 使 用 。 

3. 将 数据 传送 到 ALV 组 件 

在 表面 的 步骤 中 ， 创 建 了 ALV 输出 用 的 Context 节 上 点。 现在， 必须 把 这 个 传送 到 ALV 组 
件 。 可 以 通过 以 下 方式 来 做 到 这 一 点 : 

e 使 用 外 部 Context 映射 。 

e 使 用 方法 SET DATA. 


注 : 因为 程序 员 可 能 定义 了 不 同 的 组 件 使 用 的 各 种 不 同 的 组 件 (或 不 同 的 ALV 组 件 )， 
所 以 必须 指定 确切 的 ALV 组 件 使 用 ， 其 Context 节点 的 数据 包含 Context 映射 。 


(1) 外 部 Context 映射 

ALV 组 件 包含 一 个 单独 的 名 为 DATA 的 Context Irrt. Z I kh ALV 输出 的 结构 和 数 
据 ， 能 够 满足 显示 所 需 的 输出 。 最 简单 的 方式 是 使 用 外 部 Context. 映射 将 数据 传输 到 数据 
Context 节点 。 

(2) 方法 SET DATA 

通过 使 用 SET DATA 方法 (引用 类 型 IF WD CONTEXT NODE) 也 可 以 将 数据 传送 到 
ALV 组 件 的 Context 节点 。 可 以 这 样 做 ， 如 在 WDDOINIT 方法 调用 该 方法 。 


HS 如 果 要 以 另 一 结构 在 稍 后 进行 ALV 输出 时 ， 也 可 以 使 用 方法 SET DATA。 然 而 , 在 
这 种 情况 下 ， 不 能 在 方法 WDDOINIT 或 其 他 标准 方法 中 使 用 该 方法 。 如 果 ALV 输出 已 经 显 
示 一 次 ， 则 只 有 在 ALV 组 件 的 事件 处 理 程序 中 定义 该 数据 (调用 SET. DATA 方法 ). 


方法 SET. DATA 总 是 删除 可 能 存在 的 任何 的 ALV 配置 模型 。 如 果 想 配置 ALV 的 输出 ， 
—H. SET DATA 方法 被 调用 ， 则 程序 员 必 须 重 新 得 到 ALV 配置 模型 。 

(3) 在 ALV 组 件 中 使 用 数据 

在 ALV 组 件 的 Context 中 ，Context 节点 的 DATA 仪 包含 应 用 程序 相应 的 Context 节点 的 
引用 。 这 反 过 来 是 内 部 数据 表 的 一 个 引用 。 

默认 情况 下 ，ALYV 组 件 使 用 引用 的 数据 ， 通 过 各 种 机 制 对 数据 进行 过 滤器 ， 计 算 和 其 他 
标准 的 ALV 功能 ， 改 变 ALV 输出 ， 然 后 显示 在 屏幕 上 。 

(4) 重要 的 例外 : 排序 CSorting) 

这 里 ALV 使 用 整个 数据 集 的 数据 ， 所 以 记录 可 以 重新 排序 。 为 此 ，ALYV 组 件 暂时 控制 内 
部 数据 表 , 在 此 期 间 , 应 用 程序 相应 的 Context 节点 失效 。 这 确保 了 应 用 程序 不 能 访问 Context 
节点 ， 而 编辑 ALV 组 件 内 部 数据 表 的 数据 。 

一 旦 内 部 数据 表 已 经 重新 排序 ， 则 ALV 重建 Context 节点 ， 再 次 释放 它 的 应 用 程序 ， 并 
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显示 相应 的 数据 。 


注 : 这 样 做 确保 了 内 部 数据 表 中 的 数据 从 来 没有 被 复制 。 这 是 很 重要 的 ， 因 为 大 量 的 数 
据 将 大 大 影响 性 能 和 内 存 空间 。 


当 程 序 员 设计 应 用 程序 时 ， 请 注意 这 一 机 制 的 副作用 : 
€ 当 Context 斑点 失效 时 ， 当 前 选择 的 信息 ， 特 列 是 lead selection 选择 的 信息 将 丢失 。 
e 如 果 应 用 程序 Context 节点 中 有 子 节 点 (master-detail 方案 )， 则 当 ALV 组 件 Context 
节点 失效 时 这 些 子 节点 信息 也 将 丢失 。 如 果 应 用 程序 试图 访问 子 市 点 ， 则 运行 时 发 生 
x. 
6.1.3 使 用 ALYV 视图 


ALV 组 件 中 包含 以 下 视图 ， 可 以 根据 需要 使 用 相关 视图 : 
1) 表格 视图 。 表 视 格 图 是 ALV 的 中 央视 图 。 要 显示 ALV 的 输出 ， 束 需要 这 个 视图 。 


注 : £ UI 元 素 所 在 视图 显示 在 ALV 输出 的 容器 中 ,这 是 ALV 组 件 的 一 个 基本 组 成 部 分 。 
因此 ALV 的 布局 不 能 改变 。 


2) 服务 视图 。 

该 视 网 中 包含 “设置 ”对 话 框 ， 用 户 可 以 更 改 列 显示 的 设置 、 排 序 、 筛 选 等 。 

默认 情况 下 ， 当 用 户 选择 工具 栏 上 的 “设置 ” 超 链接 时 ， 对 话 框 在 ALV 输出 上 面 弹 出 。 

如 果 想 在 屏 友 上 的 其 他 地 方 显 示 对 话 框 ， 则 也 可 以 使 用 该 视图 。 

如 果 想 在 应 用 程序 中 显示 ALV 输出 ， 则 需要 表格 视图 。 

可 以 将 表格 视图 以 不 同 的 方式 插入 到 应 用 程序 中 : 

e 将 其 直接 插入 应 用 程序 的 窗 体 中 。 在 这 种 情况 下 ， 不 能 在 屏幕 上 显示 任何 其 他 元 素 ， 
除了 ALV 输出 。 

e 将 其 插入 到 应 用 程序 中 的 视图 集 (Web Dynpro Java 的 概念 ) 的 单元 格 。 

e 在 视图 需要 的 位 置 创 建 一 个 类 型 为 ViewContainerUIElement 的 UI 元 素 ， 然 后 将 ALV 
表格 插入 这 个 UI 元素 中 。 


6.1.4 ALV 配置 模型 对 象 


配置 ALV 输出 主要 有 以 下 儿 个 主要 方面 : 

(1) 表格 设置 

K UI 元 素 的 数据 包括 应 用 程序 结构 以 及 绪 构 内 各 字段 的 技术 设置 数据 ， 从 而 确定 ALV 
输出 的 外 观 或 功能 。 也 可 以 定义 ， 如 程序 员 可 以 定义 一 个 徐 单 的 二 维 表 或 定义 某 一 列 作为 与 
领 完 的 层次 列 的 层次 结构 列表 作为 ALV 输出 的 对 象 。 

(2) FRERE 

学 段 描述 数据 用 于 ALV 输出 。 学 段 名 称 对 应 于 Context 方 点 的 属性 名 称 ， 所 有 的 字段 对 
象 都 是 参照 指定 的 Context 节点 目 动 生 成 的 。 因 此 ， 在 ALV 配置 模型 中 的 字段 与 Context 市 
点 的 每 一 个 属性 都 具有 相同 的 名 称 。 

连接 内 部 数据 表 和 Context 节点 是 实现 使 用 ALV 局 动 应 用 程序 的 所 有 先决 条 件 。 可 以 对 
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应 用 程序 的 报表 中 的 数据 进行 排序 、 过 小 或 执行 应 用 程序 。 所 有 这 些 功 能 ALV 服务 ) 本 质 
上 是 学 段 对 和 象 的 方法 。 但 是 ， 衬 段 的 默认 状态 为 显示 。 要 想 对 某 一 字段 做 到 隐藏 ， 需 要 对 列 
进行 设置 。 

(3) JRE. 

PITRE J Wu. EEX ALV 输出 。 列 共有 与 Context 市 点 属性 和 相应 学 段 对 象 相 
同 的 名 称 。 列 对 象 中 包含 是 否 及 如 何 将 字段 名 称 相同 的 数据 在 ALV 输出 的 设置 。 如 果 不 想 显 
示 字 段 的 值 ， 则 可 以 在 程序 中 删除 相应 的 列 对 象 。 

可 以 使 用 列 议 置 来 管理 列表 中 的 所 有 列 对 象 〈 表 UI 元 素 的 列 )。 

(4) 标准 功能 设置 

ALV 提供 了 许多 功能 。 下 面 列 出 了 这 些 标准 的 ALV 功能 中 最 重要 的 几 项 。 

e ALV 服务 : 排序 、 过 滤 、 聚 合 〈 计 算 )， 以 及 设置 这 些 服务 的 选项 。 

e 可 以 在 设置 中 编辑 ALV 和 输出， 如 插入 和 删除 行 。 

e 导出 ALV 输出 到 Microsoft Excel 或 生成 PDF 格式 的 打印 版 本 。 

所 有 这 些 标 准 功 能 都 可 以 使 用 相关 的 UI 元 素 实 现 。 可 以 使 用 标准 功能 设置 隐藏 或 显示 这 
C UI 7628 

(5) 应 用 程序 特定 的 功能 设置 

可 以 根据 需要 在 用 户 的 应 用 程序 中 定义 尽 可 能 多 的 功能 ， 并 提供 合适 的 UI 7628, 通过 其 
用 户 束 可 以 运行 这 些 功能 

作为 应 用 程序 开发 人 员 ， 可 以 配置 所 有 领域 。 如 果 必 要 ， 可 以 使 用 一 个 完整 的 面 癌 对 象 
ABAP 编程 的 对 象 模型 ， 可 以 用 它 来 改变 ALV 的 输出 。 每 个 领域 是 一 个 接口 类 。 它 们 集成 到 
类 CL SALV WD CONFIG TABLE 中 。 


6.4.5 ALV 配置 模型 


为 了 使 ALV 配置 模型 可 用 ， 可 以 以 调用 相关 方法 。 例 如 ， 在 钩子 方法 WDDOINIT 中 调 
用 类 IWCI SALV_WD_TABLE 的 方法 。 可 以 选择 下 列 方法 之 一 : 

1) GET MODEL: 系统 将 返回 所 有 列 对 象 和 字段 对 象 的 完整 的 ALV 配置 模型 。 这 是 默 
认 的 情况 。 该 方法 不 具有 任何 参数 。 

2) GET MODEL EXTENDED: 系统 将 返回 所 有 的 字段 对 象 〈 如 上 )， 但 只 有 需要 时 返 
回 列 对 象 。 

例如 ， 如 果 要 管理 大 量 的 字段 对 象 ， 但 只 需要 显示 儿 列 ， 则 可 以 先 创建 第 段 对 象 ， 然 后 
根据 要 显示 列 的 内 容 创建 列 对 象 。 

方法 GET MODEL EXTENDED 中 的 参数 S PARAM (类 型 IF SALV WD TABLE=> 
S TYPE PARAM GET MODEL) £j; DEFAULT COLUMNS 字段 : 这 使 程序 员 可 以 指定 是 
合 返 回 列 对 象 。 

ME: 在 程序 运行 后 , 程序 员 可 以 指定 一 个 新 的 内 部 数据 表 用 于 ALV 输出 。 要 做 到 这 一 点 ， 
使 用 方法 SET DATA. 使 用 这 种 方法 , 还 可 以 自动 删除 整个 ALV 配置 模型 的 所 有 字段 对 象 和 
列 对 浆 。 为 了 使 配置 模型 应 用 于 新 的 数据 衣 中 ， 应 再 次 调用 方法 GET MODEL 或 方法 
GET MODEL EXTENDED. 
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6.1.6 类 图 ( Class Diagram ) 
ALV 配置 模型 的 对 象 模 型 由 以 下 类 和 接口 组 成 ， 如 图 6-1 Br. 
ES 


U 8 
| CONFIG TABLE 


Firem IF SALV WD. IF SALV WD. IF SALV WD 
AB ETT IM mi. N FIELD SETTINGS STD FUNCTIONS FUNCTION SETTINGS | 
[esent o S TU URN ES EFGUCYRT IMMO SEESSI pone ii ii t] [IDE 2c UT ENG orar om al 
EN Se SRONGDURESER TATE] L s ss ki RR RÜ k L ¿sss sssi 
| 
CL SAD/ WD 
FIELD CL SALV WD. CL SALV WU. 
一 一 一 一 一 一 一 一 FUNCTION STD FUNCTION 
BEEE M ER 
E ^j TT un  SNOUGUOOOUOUOGUOUUUUUOOUNGUNG US Kuas] 
CV STANDARD | 
IF SALV VU D T 8 CL SALY WD 
COLUMN HEADER Re OO Ee E A S E 
EE I ERCUNMANENIO 人 PEREO S NOR SCR S S TO TOI 
"SOT - "SORT AULE | FEBUTON _ 
SORT SORT RULE 
| 和 ed 
L. Ë 30000C960000800000 9006 200C 9000000C0C0C0C0C 0C0C1 Be ROS RU S S S ROS Sn gn S snos 
| 
"Tm j= 
| AGGR AGGR RULE MELT P 
ce 5858585855555555585585585i 
=== SERRESTSTRISTIR sese tco te teaetese bte se be tenet Ed 
IF SADV WD 
TABLE CELL EDITOR 
RCR 到 
Por 
IF SALV WD CL SALV WD. 
i COLUMN. REF UE BUTTON ! 
HESCIDECROMOE NEUE ERE ee 
EP e E e c 9C Ee END 
IF SALV WD _ 
COLUMN SERVICE REF UE WA FID 
[S| 
| 
—— tsk —Q A— o n DO..n, 
IF SADV WD 
COLUMN HIERARCHY [D cus 
LL— (m CO niri 
b £ s v l x= a REX g oÑ h Ts *  ( = a 


这 个 类 图 进行 了 们 化。 一 些 超级 类 在 此 图 中 已 被 删除 。 


62 ”管理 ALV 输出 领域 


ALV 输出 由 以 下 的 不 同 区 域 组 成 ， 以 在 一 定 程度 上 各 项 彼此 独立 ， 可 以 对 其 创建 、 变 更 
和 删除 。 

e JH. 

@ ALV 标题 。 

e 字段 和 列 。 

@ 列 标题 。 

e 页 肢 和 深 动 条 。 

e HAKER I KAA KAKER). 

HA up LEH A E ER] AS 


6.2.1 ALV 标题 (ALV Output Header? 
默认 情况 下 , ALV 输出 没有 标题 。 程序 员 可 以 创建 一 个 标题 , 并 在 ALV 输出 的 上 面 显示 。 
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标题 可 以 有 以 下 儿 部 分 组 成 : 文本 、 图 形 、 工 具 提 示 。 

ALV 输出 有 标题 的 ， 可 以 进行 以 下 设置 : 

e 创建 、 取 得 或 删除 标题 对 象 。 

e 设置 标题 文字 。 

e 设置 标题 网 形 路 径 。 

e 设置 标题 图 形 位置 。 

e 设置 标题 文字 工具 提示 。 

(1) 创建 、 取 得 或 删除 标题 对 象 

ALV 输出 的 标题 是 一 个 实例 的 类 CL SALV WD HEADER。 要 创建 或 删除 对 象 ， 需 使 
用 接口 类 IF SALV WD TABLE SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 
Jk, Wd 6-1. 


表 6-1 
功 能 À ik 
创建 标题 对 象 CREATE HEADER 
取得 标题 对 象 GET HEADER 
删除 标题 对 象 DELETE HEADER 


(2) 设置 标题 文字 
ALV 输出 标题 文字 类 型 为 String。 要 定义 标题 ,可 以 使 用 类 CL_SALV_WD_HEADER 中 
的 方法 ， 见 表 6-2. 


表 6-2 
JJ 能 J dE 
设置 标题 文字 SET_TEXT 
取得 标题 文字 GET TEXT 


(3) WB s £] J ERE 
可 以 在 ALV 和 输出 的 标题 区 域 显 示 任 何 图 形 ， 上 只 要 该 图 形 兼容 Web Dynpro 环境 。 要 定义 
图 形 文件 的 路 径 或 D， 使 用 类 CL SALV WD HEADER 的 方法 ， 见 表 6-3。 


表 6-3 
JJ 能 ik 
设 定 图 形 文件 的 路 径 或 ID SET IMAGE SOURCE 
取得 图 形 文 件 的 路 径 或 ID GET IMAGE SOURCE 


(4) 设置 标题 图 形 位 置 
可 以 选择 是 否 在 标题 中 文学 之 前 或 之 后 显示 图 形 。 要 做 a 到 这 一 点 ， 使 用 类 CL SALV _ 
WD HEADER 的 方法 。 
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X 能 Ao dE 
标题 内 设 定位 置 SET IMAGE FIRST 
标题 内 取得 位 置 GET IMAGE FIRST 


(5) 设置 标题 文字 工具 提示 
当 用 户 把 光标 移 到 ALV 输出 的 标题 时 , 标题 头 的 工具 提示 变 得 可 见 。 指 定 标题 头 的 提示 ， 
使 用 类 CL SALV WD HEADER 中 的 方法 ， 见 表 6-5. 


表 6-5 
功 能 J À 
设 定 工具 提示 文字 SET TOOLTIP 
取得 工具 提示 文字 GET TOOLTIP 


6.22 ”字段 


字段 对 象 可 用 于 以 下 两 种 情况 : 

1) 在 进行 ALV 输出 前 应 用 标准 的 ALV 功能 〈ALV 服务 )。 
2) 要 分 配 一 个 单元 格 内 字段 的 属性 。 

还 可 以 对 字段 对 象 进行 以 下 设置 : 

1) 取得 字段 对 象 。 

2) 取得 字段 名 称 。 


注 : 可 以 创建 新 的 字段 或 删除 现 有 的 字段 。 


d) 取得 字段 对 象 

要 为 一 个 字段 进行 必要 的 设置 ， 必 须 先 得 到 该 字段 的 实例 。 可 以 决定 是 否 针对 特定 的 字段 对 
象 〈 通 过 名 称 取得 ) 或 得 到 所 有 的 字段 对 象 〈 一 个 一 个 进行 处 理 )。 在 这 两 种 情况 下 ， 可 以 使 用 
接口 类 IF SALV WD FIELD SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 
见 表 6-6. 


表 6-6 
Jj 能 WEE 
取得 单个 学 段 对 象 GET FIELD 
取得 所 有 学 段 对 象 GET FIELDS 


(2) 取得 字段 名 称 
取得 当前 字段 实例 的 名 称 ， 可 以 使 用 类 CL SALV WD FIELD, W 6-7. 


表 6-7 
X Ë 
取得 字段 名 称 GET FIELDNAME 


CC 
ax 
N 
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(3) 创建 或 删除 字段 对 象 

调用 ALV 时 ， 相 应 的 字段 对 象 或 参照 指定 的 Context 节点 属性 自动 创建 。 但 是 ， 在 特殊 
情况 下 ， 程 序 员 可 能 需要 创建 或 删除 字段 对 象 。 

当 创 建 一 个 字段 对 象 时 ， 需 要 和 输入 它 的 技术 名 称 。 访 名称 必 须 与 应 用 程序 的 Context Ti 53 
中 的 属性 的 名 称 一 致 。 可 使 用 接口 类 IF SALV WD FIELD SETTINGS (实现 类 CL SALV 
WD CONFIG TABLE) 中 的 方法 ， 见 表 6-8. 


表 6-8 
功 能 Ie s 
创建 字段 对 象 CREATE FIELD 
删除 字段 对 象 DELETE FIELD 
6.2.3 A 


根据 如 何 取得 的 ALV 配置 模型 ， 要 么 只 有 一 个 与 Context 节点 属性 相同 名 称 的 列 对 象 ， 
要 么 没有 列 对 象 。 如 果 没 有 列 对 象 ， 则 必须 创建 显示 ALV 输出 所 需要 的 列 对 象 。 

对 于 列 对 象 ， 可 以 进行 以 下 设置 : 

e DUO ANS. 

e 取得 列 对 象 的 技术 名 称 。 

e 创建 和 删除 茶 一 列 对 象 。 

e 设置 列 标题 。 

e 更 改 某 一 列 对 象 的 位 置 。 

(1) 取得 示 一 列 对 象 

要 为 某 一 列 进行 必要 的 设置 ， 首 先 必须 获得 该 列 的 实例 。 可 以 根据 名 称 针对 特定 的 列 对 
象 进行 设置 或 一 次 获得 所 有 的 列 对 象 ， 然 后 一 个 一 个 处 理 。 在 这 两 种 情况 下 ， 都 可 以 使 用 接 
品类 IF SALV WD COLUMN SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 方 
ik, Dix 6-9。 


表 6-9 
E fë 24: - We 
取得 单独 列 对 象 GET COLUMN 
取得 所 有 列 对 和 象 GET COLUMNS 


(2) 取得 列 对 象 的 技术 名 称 
使 用 的 类 CL SALV WD COLUMN 得 到 当前 列 的 实例 的 名 称 ， 见 表 6-10. 
表 6-10 
Jj 能 m 3A 
取得 技术 名 称 GET ID 
(3) 创建 和 删除 茶 一 列 对 象 


如 果 取 得 ALV 配置 模型 时 ， 所 指定 的 系统 没有 生成 列 对 象 ， 则 需要 创建 应 用 程序 进行 
ALV 数据 显示 所 需 的 列 对 象 。 
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列 对 象 存在 的 所 有 列 显示 在 一 个 列 集中 。 如 果 不 和 希望 某 一 列 出 现在 用 户 的 列 集中 ， 则 必 
须 删 除 相应 的 列 对 象 。 

注 : 当 创建 一 个 列 对 象 时 ， 需 要 输入 它 的 技术 名 称 。 该 名 称 必 须 与 应 用 程序 Context 节点 
中 的 属性 的 名 称 一 致 。 

要 创建 或 删除 列 对 象 ， 可 使 用 接口 类 IF SALV WD COLUMN SETTINGS (实现 类 
CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-11. 


表 6-11 
Jj 能 I 395 
创建 一 个 列 对 象 CREATE COLUMN 
删除 一 个 列 对 象 DELETE COLUMN 
删除 所 有 列 对 象 DELETE COLUMNS 


6.2.3.1 JRE 

默认 情况 下 ，ALYV 输出 中 的 每 一 列 中 有 一 列 标题 。 不 必 因 此 必须 首先 创建 相应 的 列 对 象 
(可 以 多 个 列 用 一 个 标题 )。 

可 以 更 改 列 标题 。 更 改 时 可 以 设置 以 下 组 件 : 文本 、 图 形 、 工 具 提 示 。 

可 以 为 列 标题 进行 如 下 设置 : 

e 创建 、 取 得 、 删 除 列 对 象 的 列 标题 。 

e 指定 列 标题 的 文字 。 

e 指定 列 标题 中 的 网 形 路 径 。 

e 在 列 标题 中 指定 网 形 位 置 。 

@ 指定 列 标题 文字 的 工具 提示 。 

(1) 关于 标准 列 标题 的 信息 

标准 列 标题 包含 文字 内 容 。 所 使 用 的 文字 依赖 于 Context 节点 的 属性 。 

1) 如 果 属 性 没有 DDIC 引用 ， 默 认 情 况 下 ， 系 统 使 用 属性 的 技术 名 称 作为 列 标题 。 

2) 如 果 属 性 有 一 个 DDIC 引用 ， 系 统 分 配 的 列 标题 如 下 : 

e 如 果 已 定义 DDIC 数据 元 素 ， 则 系统 采用 DDIC 数据 元 素 的 短文 本 字段 标签 作为 列 

标题 。 

@ 如 果 没 有 被 定义 字段 标签 ， 则 系统 采用 DDIC 数据 元 素 的 技术 名 称 作为 列 标题 。 

(2) 创建 、 取 得 、 删 除 列 对 象 的 列 标题 

ALV 输出 中 的 列 的 列 标题 是 类 CL SALV WD COLUMN HEADER 的 实例 。 列 标题 对 象 
可 以 存在 于 每 一 列 对 象 中 。 

要 取得 、 创 建 或 删除 列 标题 对 象 ， 可 以 使 用 类 CL SALV WD COLUMN 中 的 方法 ， 见 
表 6-12。 


表 6-12 
E BÉ Io ` 
取得 列 标题 对 象 GET HEADER 
创建 列 标题 对 象 CREATE HEADER 
删除 列 标题 对 象 DELETE HEADER 
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(3) 指定 列 标 题 的 文字 

指定 要 显示 的 列 标题 的 文本 ， 可 有 以 下 几 种 方法 : 

1) 输入 用 户 定义 的 文本 。 

2) 输入 一 个 单独 的 DDIC 数据 元 素 被 用 来 作为 列 标题 的 字段 标签 。 

对 于 和 DDIC XZ, HIA DDIC 的 数据 元 素 作为 切入 点 ， 返 回 列 标题 的 文本 。 为 此 ， 
需要 使 用 方法 SET PROP DDIC BINDING ELEMENT， 完成 以 下 工作 : 

1) 列 标题 或 工具 提示 。DDIC 的 文本 说 明 是 用 来 作为 列 标题 的 。 

2)DDIC 数据 元 素 的 名 称 。 默 认 情况 下 , 使 用 DDIC 数据 元 素 的 短文 本 。 还 可 以 使 用 DDIC 
数据 元 素 的 heading XÆ, medium 文本 或 长 文本 为 此 ， 需 要 使 用 方法 SET PROP DDIC- 
BINDING FIELD. 


RE: 如 果 输 入 用 己 定 义 的 文本 作为 列 标题 , 则 必须 使 用 该 方法 显 式 地 关闭 与 DDIC 的 
要 指定 列 标题 的 文本 ， 可 以 使 用 类 CL SALV WD COLUMN HEADER 中 的 方法 ， 见 
表 6-13. 


表 6-13 

功 能 o ”法 
指定 任何 文字 作为 列 标题 SET TEXT 
明确 取消 与 DDIC 的 关系 SET PROP DDIC BINDING FIELD 
取得 列 标题 的 文本 GET TEXT 
指定 DDIC 数据 元 素 的 字段 标签 用 来 作为 列 标题 SET PROP DDIC BINDING ELEMENT 
取得 DDIC 数据 元 素 的 名 称 GET PROP DDIC BINDING ELEMENT 
指定 字段 标签 的 类 型 ， 用 来 作为 列 标题 SET PROP DDIC BINDING FIELD 
取得 学 段 标签 的 类 型 用 作 列 标题 GET PROP DDIC BINDING FIELD 


(4) 列 标题 换行 

默认 情况 下 ， 系 统 在 列 标题 中 不 添加 换行 符 。 因 此 ， 列 的 宽度 由 列 标题 中 的 文本 的 长 度 
决定 。 在 列 标题 中 ， 程 序 员 可 以 指定 换行 符 。 如 果 列 标题 包含 的 字符 允许 换行 (如 空格 或 连 
字符 ) 或 者 列 不 够 宽 ,， 系统 可 以 把 文学 拆 成 多 行 。 要 做 到 这 一 点 , 可 以 使 用 类 CL SALV_WD 
COLUMN HEADER 的 方法 ， 见 表 6-14. 


表 6-14 
E 能 Ao dE 
设 定 换行 SET HEADER TEXT WRAPPING 
确定 列 标题 中 是 否 有 换行 设置 GET HEADER TEXT WRAPPING 


(5) 指定 列 标题 中 的 图 形 路 径 
可 以 在 列 标题 中 显示 任何 图 形 , 只 要 该 图 形 兼 容 Web Dynpro 环境 。 要 指定 图 形 文件 的 路 
径 或 ID， 可 以 使 用 类 CL SALV WD COLUMN HEADER 方法 ， 见 表 6-15. 
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表 6-15 


J 能 J dE 
指定 图 形 的 路 径 或 ID SET IMAGE SOURCE 
取得 图 形 的 路 径 或 ID GET IMAGE SOURCE 


(6) 在 列 标题 中 指定 图 形 位 置 
在 列 标题 中 可 以 选择 是 否 将 网 形 显示 在 列 标题 的 文本 之 前 或 之 后 。 要 做 到 这 一 点 ， 可 以 
使 用 类 CL SALV WD COLUMN HEADER 中 的 方法 ， 见 表 6-16. 


表 6-16 
X 能 J dE 
指定 在 标题 内 图 形 的 位 置 SET IMAGE FIRST 
取得 在 标题 内 图 形 的 位 置 GET IMAGE FIRST 


CI) 指定 列 标题 文字 的 工具 提示 

当 用 户 把 光标 移 到 列 标题 时 ， 列 标题 显示 工具 提示 。 

指定 要 显示 的 提示 文字 有 以 下 几 种 方式 : 

e 可 以 指定 任何 文学 。 

e 可 以 输入 一 个 早 独 的 DDIC 数据 元 素 的 字段 标签 用 来 作为 工具 提示 。 

注 : 除了 方法 之 外 ， 设 置 标题 工具 提示 与 DDIC 之 间 的 关系 一 样 ， 同 样 可 以 利用 DDIC 
数据 元 素 的 短 、 中 、 长 及 标题 标签 文本 作为 工具 提示 文本 。 


要 指定 提示 的 文本 ， 使 用 类 CL SALV WD COLUMN HEADER 中 的 方法 ， 见 表 6-17. 


表 6-17 

Yy 能 JH “法 
指定 任何 文字 作为 列 标题 工具 提示 文本 SET TOOLTIP 
明确 取消 与 DDIC 的 关系 SET PROP DDIC BINDING FIELD 
取得 列 标题 工具 提示 的 文本 GET TOOLTIP 
指定 DDIC 数据 元 素 的 字段 标签 用 来 作为 列 标题 工具 提示 文本 SET PROP DDIC BINDING ELEMENT 
取得 DDIC 数据 元 素 的 名 称 GET PROP DDIC BINDING ELEMENT 
指定 字段 标签 的 类 型 ， 用 来 作为 列 标题 工具 提示 文本 SET PROP DDIC BINDING FIELD 
取得 学 段 标签 的 类 型 用 作 列 标题 工具 提示 文本 GET PROP DDIC BINDING FIELD 


6.2.3.2 JAE 

默认 情况 下 , 所 有 列 的 排序 与 应 用 程序 的 Context 节点 中 的 属性 顺序 相同 。 程 序 员 可 以 通 
过 以 下 方式 更 改 列 的 顺序 : 通过 改变 位 置 号 码 、 固 定 列 。 也 可 以 指定 是 否 允 许 用 户 来 固定 列 。 

(1) 改变 位 置 写 人 码 

系统 目 动 分 配给 每 一 列 一 个 位 置 编写。 可 以 通过 改变 这 个 位 置 编号 更 改 位 置 的 列 。 这 里 
的 位 置 编写 不 是 唯 一 的 。 


注 : 位 置 编号 为 0 的 列 在 最 左边 。 这 意味 着 ， 如 果 要 把 某 一 列 放 到 左 侧 ， 则 必须 给 一 个 
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比 其 他 列 较 高 的 位 置 编号 。 

也 可 以 使 用 负数 的 位 置 编 号 。 这 意味 着 ， 给 定 某 一 列 适当 的 位 置 ， 不 改变 所 有 其 他 列 的 
0 的 位 置 编号 。 

要 改变 列 的 位 置 编 号 ， 可 以 使 用 类 CL SALV WD COLUMN 中 的 方法 ， 见 表 6-18. 


表 6-18 
J JU 能 J^ og 
设 定位 置 编号 SET POSITION 
取得 位 置 编号 GET POSITION 


(2) 固定 列 

可 以 将 重要 列 固定 。 这 具有 以 下 效果 : 

e 将 列 放 在 ALV 输出 的 边缘 。 

e 深 动 侧身 的 水 平 深 动 条 列 可 以 不 再 被 移动 。 

一 列 固定 时 ， 可 以 在 ALV 输出 中 指定 该 列 是 否 是 被 固定 到 的 左手 侧 或 右手 侧 。 

在 这 种 方式 中 ， 最 多 可 以 创建 以 下 3 个 区 块 的 列 : 列 固定 到 左 ， 列 是 不 固定 的 ， 列 固定 


到 右 。 
还 可 以 更 改 一 列 的 位 置 编号 ， 以 固定 其 位 置 。 这 使 程序 员 可 以 根据 自己 的 位 置 编号 排列 
所 有 列 块 。 
要 固定 某 一 列 ， 可 以 使 用 类 CL SALV WD COLUMN 中 的 方法 ， 见 表 6-19. 
表 6-19 
JJ 能 Jn WA 
固定 某 一 列 SET FIXED POSITION 
检查 某 一 列 是 人 否 被 固定 ， 并 返回 其 固定 位 置 GET FIXED POSITION 


(3) 允许 列 固 定 

可 以 指定 是 否 允 许 用 户 固定 个 别 列 。 指 定 这 些 列 分 别 固 定 到 右边 缘 或 左边 缘 。 在 ALV 输 
出 页 面 中 单 击 “ 设 置 ”按钮 ， 在 弹出 对 话 框 中 ， 用 户 可 以 指定 固定 列 的 数量 。 

为 了 让 列 可 以 固定 ， 可 以 使 用 接口 类 IF SALV WD STD FUNCTIONS (实现 类 CL 
SALV WD TABLE) 的 方法 ， 见 表 6-20. 


表 6-20 
JJ 能 X. uw 
允许 列 在 ALV 输出 的 左边 缘 固 定 SET FIXED COLS LEFT ALLOWED 
检查 用 户 是 否 被 允许 在 ALV 输出 的 左边 缘 固定 列 IS FIXED COLS LEFT ALLOWED 
允许 列 在 ALV 输出 的 右边 缘 固 定 SET FIXED COLS RIGHT ALLOWED 
检 碍 用户 是 否 被 允许 在 ALV 输出 的 右边 缘 固定 列 IS FIXED COLS RIGHT ALLOWED 


6.2.4 ”页 肢 和 深 动 条 


ALV 输出 的 页 脚 中 总 是 包含 垂直 滚动 条 (paginators )， 也 可 以 包含 水 平 ( 深 动 条 ) 


(paginators). 
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可 以 对 页 脚 和 深 动 条 进行 以 下 设置 : 

e inb UL. 

e 显示 水 平 滚动 条 。 

e 水 平 或 重生 深 动 。 

(1) 显示 或 隐 兰 页 脚 

ALV 输出 第 一 次 显示 一 般 有 太 多 的 条 目 。 用 户 不 使 用 深 动 条 束 无 法 合 看 后 面 的 条 目 ; 相 
反 ， 必 须 在 页 脚 使 用 的 滚动 条 导航 到 所 需 的 位 置 。 

如 果 ALV 输出 包含 大 量 的 数据 记录 , 则 程序 员 必 须 确保 为 用 户 提 供 包 含 深 动 条 的 页 脚 。 

程序 员 还 可 以 控制 页 脚 中 的 深 动 条 什么 时 候 可 见 ， 什 么 时 候 不 可 见 。 

1) 不 可 见 : 即使 项 目 和 被 隐 闫 在 看 不 匈 的 区 形 ， 页 脚 也 不 显示 。 

2) 始终 可 见 : 即使 所 有 的 条 目 在 任何 时 间 都 是 可 见 的 ， 显 示 页 脚 。 在 这 种 情况 下 ， 滚 动 
ARCHI. 

3) 仪 在 需要 时 可 见 。 如 条 在 ALV 输出 中 有 更 多 的 行 和 列 可 以 显示 ， 则 才 显 示 页 脚 。 

要 显示 或 隐藏 页 脚 ， 使 用 接口 类 IF SALV WD TABLE SETTINGS (实现 类 CL SALV 
WD CONFIG TABLE) 中 的 方法 ， 见 表 6-21. 


表 6-21 
E 能 7 
显示 页 脚 SET FOOTER VISIBLE 
检查 页 脚 是 否 显 示 GET FOOTER VISIBLE 


(2) 显示 水 平 深 动 条 

默认 情况 下 ， 所 有 列 标记 为 可 见 的 显示 方式 。 用 户 可 以 在 浏览 器 窗 体 中 使 用 水 平 滚动 条 
浏览 到 所 需 的 位 置 。 

程序 员 可 以 定义 滚动 多 少 所 有 列 才 是 可 见 的 ， 从 而 确定 ALV 输出 的 宽度 。 用 户 需 要 使 用 
滚动 条 顺序 移动 不 可 见 列 到 可 见 区 。 

注 : 无 论 选 择 多 少 可 见 行 ， 重 直 滚 动 条 总 是 可 见 的 。 

然而 ， 水 平 滚动 条 在 定义 湾 动 列 数 后 才 可 见 。 如 果 设 置 这 个 数字 足够 高 使 得 所 有 列 是 可 
见 的 ， 则 滚动 条 被 关闭 。 


定义 可 见 列 的 数量 ， 从 而 确定 是 否 要 显示 或 隐 蔚 滚动 条 ， 使 用 接口 类 IF SALV_WD 
TABLE SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-22. 


表 6-22 
JJ 能 "WEE - 
定义 可 滚动 列 数 SET SCROLLABLE COL COUNT 
取得 可 滚动 列 数 GET SCROLLABLE COL COUNT 


(3) 水平 或 垂直 滚动 

用 户 需 要 滚动 条 投 钮 ， 以 推动 ALV 输出 中 看 不 见 的 列 或 行 到 可 见 区 域 。 用 户 也 可 以 在 
ALV 输出 时 ， 使 用 深 动 条 输入 字段 输入 要 被 显示 的 行 或 列 为 第 一 个 可 见 的 行 或 列 。 

无 论 是 否 显 示 页 脚 ， 用 户 都 可 以 使 用 ALYV 配置 模型 来 定义 显示 的 行 或 列 。 
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HS 要 指定 第 一 行 ， 需 使 用 该 行 的 索引 。 指 定 第 一 列 时 ， 需 使 用 该 列 的 技术 名 称 。 


在 ALV 输出 中 要 滚动 到 所 需 的 列 或 行 ， 使 用 接口 类 IF SALV WD TABLE SETTINGS 
(实现 类 CL SALV WD CONFIG CLASS) 的 方法 ， 见 表 6-23. 


表 6-23 
Yy 能 ar^ WE 
指定 要 被 显示 的 行为 第 一 行 SET FIRST VISIBLE ROW 
取得 第 一 行 GET FIRST VISIBLE ROW 
指定 要 被 显示 的 列 为 第 一 列 SET FIRST VISIBLE SCROLL COL 
取得 第 一 列 GET FIRST VISIBLE SCROLL COL 


6.2.5 ”页 眉 与 页 脚 区 域 


HP H UE ALV 输出 的 上 方 和 下 方 使 用 各 种 元 素 设计 页 眉 与 页 脚 。 可 以 使 用 设计 对 象 进 
行 相关 操作 。 

程序 员 可 以 使 用 许多 不 同 的 类 型 的 元 素 ， 以 形成 一 个 设计 对 象 ， 然 后 显示 在 想 要 的 位 置 。 

WS 所 有 设计 对 象 的 类 和 方法 在 系统 内 的 SALV_ FORM ELEM 包 中 。 


(1) 元 聂 类 型 和 布局 形式 

可 以 使 用 下 列 类 型 的 元 素来 设计 对 象 : 

€ Header 元 素 〈 头 信息 )。 

e 市 或 不 带 标 签 的 文本 元 素 〈 文 本 标签 )。 
e 动作 信息 。 


注 : 这 些 元 素 只 在 外 观 上 有 所 不 同 。 各 类 型 元 素 没有 相关 功能 连接 。 


这 些 元 素 可 以 排列 在 设计 对 象 中 。 可 以 选择 的 布局 表单 有 以 下 3 种 : 
e 单元 系 : 生成 一 个 元 么 ， 并 将 其 显示 在 押 需 的 位 置 。 

€ Row-type 布局 : 排列 尽 可 能 多 的 元 么 ， 将 其 一 前 一 后 排 成 一 排 。 
© Table-type 布局 : 安排 尽 可 能 多 的 元 素 ， 将 其 排列 成 行 和 列 。 


NS 可 以 将 二 者 结合 起 来 布局 表单 ， 如 可 以 将 行 插入 到 一 个 表 中 。 


(2) Context 节点 TOP OF LIST 和 END OF LIST 

ALV 组 件 提 供 了 两 个 Context 节点 TOP OF LIST 和 END OF LIST。 每 个 节点 包含 一 
个 CONTENT 属性 ,这 些 Context 1 AHT ALV 输出 中 保存 页 眉 和 页 脚 区 域 的 设计 对 象 的 
数据 。 

可 以 定义 Context 映射 到 应 用 程序 一 个 相同 的 名 称 Context WAE, HKZ Context 设置 
到 设计 对 象 的 属性 。 

(3) 设置 设计 对 象 (Design Object) 

设置 设计 对 象 的 页 由 和 页 脚 区 域 的 步骤 如 下 : 

1) 映射 ALV 组 件 的 Context 节点 TOP. OF LIST 和 END OF LIST 到 应 用 程序 Context 中 。 
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2) 创建 一 个 设计 对 象 。 要 做 到 这 一 点 ， 可 以 使 用 row-type 或 table-type 布局 。 将 所 需 的 
元 素 插入 到 这 个 布局 中 。 

3) 如 有 需要 ， 将 元 系 进 行 各 种 设置 〈 设 计 对 象 设 置 )。 

4) 将 设计 对 象 设置 为 Context TAH CONTENT 属性 。 

(4) 设计 对 象 的 显示 和 隐 减 

默认 情况 下 ， 页 眉 区 设计 对 象 和 页 脚 区 的 设计 对 象 都 显示 出 来 。 

隐藏 和 显示 这 两 种 设计 对 象 ， 可 以 使 用 接口 SALV WD TABLE SETTINGS (实现 类 
的 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-24. 


表 6-24 
JJ 能 A3 
显示 或 隐藏 的 页 眉 区 域 设 计 对 象 SET TOP OF LIST VISIBLE 
检 碍 页 眉 区 域 设计 对 象 是 否 显示 或 隐藏 GET TOP OF LIST VISIBLE 
显示 或 隐藏 的 页 脚 区 域 设计 对 和 象 SET END OF LIST VISIBLE 
JS vt AD 区域 设计 对 象 是 否 显示 或 隐藏 GET END OF LIST VISIBLE 


6.2.5.1 ”创建 设计 对 象 和 元 素 

(1) 创建 一 个 设计 对 象 

首先 ， 确 定 设 计 对 象 的 基本 布局 。 在 显示 时 ， 可 以 决定 在 一 行 里 显示 一 个 单一 的 元 素 或 
者 一 排 的 元 素 序 列 ， 或 将 多 个 元 素 按照 某 种 顺序 设置 到 多 个 行 和 列 中 。 使 用 表 6-25 中 的 类 用 
于 此 目的 。 


表 6-25 
di 局 类 
Row-type 布局 CL SALV FORM LAYOUT FLOW 
Table-type 布局 CL SALV FORM LAYOUT GRID 


当 创建 一 个 标签 类 型 的 元 素 时 ， 必 须 指 定 相应 的 文本 元 素 。 这 意味 着 程序 员 不 能 使 用 这 
个 元 素 作为 设计 对 象 中 的 单个 元 素 。 

(2) 创建 单个 元 素 

已 经 创建 了 一 个 布局 设计 对 象 后 ， 可 以 使 用 表 6-26 中 的 方法 来 创建 各 种 类 型 的 元 素 : 这 
些 方 法 可 以 在 类 CL SALV FORM LAYOUT FLOW 和 CL SALV FORM LAYOUT GRID 中 
找到 。 


表 6-26 

HJ 能 方 ” 法 
创建 Row-type 类 型 布局 《可 用 于 藤 套 ) CREATE FLOW 
创建 Table-type KH fi CHI HT GEO CREATE GRID 
创建 文本 元 素 CREATE TEXT 
创建 特定 的 文本 元 素 的 标签 CREATE LABEL 
创建 页 眉 元 素 CREATE HEADER INFORMATION 
创建 动作 信息 CREATE ACTION INFORMATION 
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可 以 使 用 表 6-27 "pa Guo ARTIS e 


表 6-27 

元 素 类 型 类 
Row-type KHIR jy CJH FRKE) CL SALV FORM LAYOUT FLOW 
Table-type 287i ja CRT RIT CES CL SALV FORM LAYOUT GRID 
文本 元 素 CL SALV FORM TEXT 
标签 元 素 CL SALV FORM LABEL 
标题 信息 CL SALV FORM HEADER INFO 
动作 信息 CL SALV FORM ACTION INFO 


MS 行 类 型 的 布局 的 创建 不 需要 参数 。 表 型 布局 创建 时 需 指 定 行 和 列 的 参数 。 当 创 
元 素 类 型 标签 时 ， 必 须 指定 相应 的 文本 元 素 (R LABEL FOR )， 无 论 所 处 的 布 


T 
> 
ah 


6.2.5.2 ERIR 

程序 员 可 以 对 设计 对 象 作 相关 设 定 ， 并 可 以 为 每 个 设计 对 象 包含 的 元 素 作 相关 设 定 ， 在 
table-type 布局 的 情况 下 ， 也 可 以 为 单独 的 列 作 相关 设 定 。 

(1) 设计 对 象 设置 

程序 员 可 以 对 设计 对 象 元 素 进行 以 下 设置 ， 见 表 6-28 布局 为 Flow FF) 和 表 6-29 Cf 
局 为 Grid FF). 


表 6-28 
JJ 能 ik 
设 定 布局 内 元 素 SET ELEMENT 
取得 Row-type 布局 中 的 元 素数 GET ELEMENT COUNT 
设 定 工具 提示 的 设计 目标 SET TOOLTIP 
取得 工具 提示 为 设计 对 象 GET TOOLTIP 
表 6-29 
JJ Bé I 
设 定 布局 内 元 素 SET ELEMENT 
附加 的 空 行 CFLOW 对 象 ) ADD ROW 
取得 的 行 数 GET ROW COUNT 
显示 列 和 行 之 间 的 网 格 SET GRID LINES 
设 定 工 具 提 示 的 设计 目标 SET TOOLTIP 
取得 工具 提示 为 设计 对 象 GET TOOLTIP 


(2) 议定 元 于 
可 为 不 同类 型 的 元 素 设 定 相 似 的 功能 ， 见 表 6-30. 
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EE PR CL SALV FORM TEXT 
取得 元 素 的 文本 CL SALV FORM LABEL 
RUIT - CL SALV. FORM HEADER INFO 
CL SALV. FORM LABEL 
(3) 设 定 列 的 宽度 及 对 齐 
一 列 在 Table-type 布局 中 的 设计 对 象 是 类 CL SALV FORM GRID COLUMN 的 一 个 对 
象 。 可 以 使 用 类 CL SALV FORM LAYOUT GRID 一 次 创建 多 个 列 的 对 象 ， 具 体 方法 见 
X 6-31. 


xx 6-31 
功 Bé À 3k 
取得 列 GET COLUMN 
在 表 布 局 中 创建 列 SET COLUMN COUNT 
取得 表 布 局 中 的 列 数 GET COLUMN COUNT 
可 以 使 用 列 对 象 来 定义 列 的 宽度 和 对 齐 列 中 的 元 素 ， 有 具体 方法 见 表 6-32. 
表 6-32 
JJ 能 Z^ xA 
设 定 列 宽 SET WIDTH 
取得 列 宽 GET WIDTH 
设 定 元 素 水 平 对 齐 方式 SET H ALIGN 
取得 元 素 水 平 对 齐 方式 GET H ALIGN 


(4) 单一 元 素 的 宽度 和 对 章 方式 设 定 

可 以 定义 个 别 元 系 的 宽度 和 对 章 方式 。 由 于 技术 原因 ， 必 须 确定 该 元 素 是 否 在 Row-type 
布局 或 Table-type 布局 。 

e 对 于 Row-type 布局 ， 使 用 类 CL SALV FORM LAYOUT DATA FLOW. 

e 对 于 Table-type 布局 ， 使 用 类 CL SALV FORM LAYOUT DATA GRID. 

要 更 改 布局 数据 ， 必 须 首 先 确 定 布局 关 型 。 取 得 元 系 布 局 的 方法 见 表 6-33。 


表 6-33 


JJ 能 Ze o 
获取 元 素 的 对 齐 和 宽度 的 布局 数据 GET LAYOUT DATA 


SEXE Y Jus J WJ IS yk, MERHAR, ILE 6-34. 
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表 6-34 


Ji Bë T Q 
设 定 宽度 SET WIDTH 
取得 宽度 GET WIDTH 
设 定 水 平 对 齐 SET H ALIGN 
取得 水 平 对 齐 GET H ALIGN 


6.2.5.3 ”设计 对 象 实 例 
(1) table-type 布局 ALV 输出 的 页 局 
下 和 面 的 示例 演示 如 何在 Table-type 布局 的 ALV 输出 的 页 眉 中 插入 一 个 说 计 对 象 : 


Ta TOF OF LIST 
data: 
lr_node type ref to if wd_context_node, 


Ir grid type ref to cl salv form layout grid, 


Ir text type ref to cl salv form text, 
Ir label type refto cl salv form label. 


create object lr grid. 

lr text= Ir grid-^»create text( 
text = '1.2 TEXT 

row = 1 

column = 2 ). 

lr label = Ir grid->create label( 
text ='1.1 LABEL 

row = 1 

column = 1 

r label for=lr text). 

lr text = Ir grid->create text( 
text = '2.2 TEXT 

row = 2 

column = 2 ). 

Ir label = 1r grid->create label( 
text ='2.1 LABEL' 

row=2 

column = ] 

r label for= lr text). 

lr node = wd context-^get child node( name = TOP OF LIST'). 


call method Ir node-»set attribute 
exporting 

value = lr grid 

name = 'CONTENT'. 
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(2) Row-Type 布局 ALV 输出 的 页 脚 
下 和 面 的 例子 演示 了 如 何在 ALV 输出 的 页 脚 中 显示 一 个 文本 关 型 的 元 素 : 


*.. END OF LIST 
data: 


Ir node type ref to if wd context node, 


Ir flow type ref to cl salv form layout flow, 


lr text type ref to cl salv form text. 

create object Ir flow. 

lr text= Ir flow-^create text( 

text =  MyText). 

lr node = wd context-^get child node( name = END OF LIST ). 
call method lr node-»set attribute 

exporting 

value = Ir flow 

name = CONTENT. 


6.2.6 Wd WE 


一 些 UI 元 素 的 ALV 标准 功能 都 位 于 一 个 特殊 的 领域 :“ 设 置 ” 对 话 框 。 

默认 情况 下 ,“ 设 置 ” 对 话 框 显示 为 一 个 ALV 输出 上 方 的 ALV 组 件 接口 的 接口 视图 
服务 。 程 序 员 可 以 为 应 用 程序 指定 是 否 以 对 话 框 形式 显示 ， 也 束 是 说 ， 是 否 在 ALV 输出 上 方 
作为 一 个 弹出 窗口 。 

ALV 输出 时 对 话 框 被 隐藏 。 用 户 可 以 把 “设置 ”对 话 框 放置 在 工具 栏 上 。 

(1) 对 话 框 的 按钮 

用 户 在 该 对 话 框 中 进行 设置 ， 可 以 用 以 下 两 种 方法 应 用 到 ALV 输出 ， 如 图 6-2 所 示 。 


视图 |[ 标 准 视图 ] 


e] [ss | [S858] [S ] [I 
Aiei | 排序 | aiea | 显示 | FIERA BS 


CT m EZRA NN 
班级 

ug 
FEES 
M 
iB 
数学 成 绩 
自然 成 绩 

思 品 成 绩 M 


[z] [人 | 更改 顺序 [=] [=] 


[BE [WB J Ei 
图 6-2 
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1) 使 用 “应 用 ”按钮 : 适用 于 ALV 得 出 的 设置 。 访 对话 框 保持 打开 状态 ， 用 户 可 以 进 
行进 一 步 的 设 定 。 

2) 使 用 “确定 ”按钮 : 适用 于 ALV 输出 的 设置 。 对 话 框 关闭 。 

当 用 户 单 击 “ 了 取消” 对 话 框 时 ， 关 闭 对 话 框 ，ALYV 输出 保持 不 变 。 

(2) 显示 一 个 弹出 的 对 话 框 

作为 一 个 单独 的 模式 对 话 框 显示 “设置 ”对 话 框 ， 可 以 使 用 接口 类 IF_SALV_WD STD. 
FUNCTIONS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-35. 


表 6-35 
JJ 能 ur WA 
显示 一 个 弹出 式 对 话 框 SET DIALOG SETTINGS AS POPUP 
检查 是 否 显 示 为 一 个 弹出 的 对 话 框 IS DIALOG SETTINGS AS POPUP 


6.3 ALV 输出 的 外 观 


程序 员 可 以 用 各 种 方式 更 改 ALV 输出 的 外 观 。 可 以 指定 以 下 内 容 : 
€ ALV 输出 ， 列 和 单元 格 的 大 小 。 

e 个 别 区 域 的 可 见 性 。 

€ ALV 输出 ， 列 和 单元 格 的 磊 色 。 

e 文本 属性 。 

e 列 和 行 之 间 的 网 格 。 

e 树 状 层次 结构 表 。 

e 表 数 据 作 为 业务 图 形 输出 。 


6.3.1 将 属性 分 配给 列 和 单元 格 


可 以 通过 以 下 两 种 分 配方 式 影响 ALV 列 输出 外 观 的 大 部 分 的 属性 : 

1) 将 属性 分 配 到 整个 列 。 列 中 的 每 个 单元 格 都 具有 这 个 属性 。 

2) 在 每 一 个 单元 格 中 分 配 不 同 的 字段 ， 当 该 单元 格 出 现在 当前 列 中 时 将 指定 的 这 个 字段 
分 配给 当前 列 。 

这 使 程序 员 可 以 指定 所 需 的 属性 到 单独 的 单元 格 。 

程序 员 还 可 以 指定 下 和 面 的 属性 : 

1) 列 的 背景 颜色 (SET CELL DESIGN zk SET CELL DESIGN FIELDNAME). 

2) 单元 格 的 变 式 (SET SELECTED CELL VARIANT 或 SET SEL CELL VARIANT - 
FIELDNAME). 

S5 Ws] — AE Fi POLES] E Fr E A rh i ZUR RKR. A A RE TA i 
FASIE EM E RT oz — 90: 对 于 编辑 器 的 所 有 实例 ， 这 些 属性 可 以 是 有 效 的 ， 也 可 以 被 
一 个 字段 的 信息 窗 盖 。 

例子 : 

在 一 列 中 ,程序 员 使 用 BUTTON 单元 编辑 器 ， 每 个 单元 被 显示 为 一 个 按钮 ， 但 是 要 在 此 
列 中 隐藏 一 些 单元 格 。 


LEE 


由 于 visibility J&TEZEZE T TEL], W 4563520, DN DURER] — PRAE 77 12: B yel ER. 
元 格 。 

1) 参照 类 CL SALV WD UIE BUTTON 创建 一 个 对 象 Chi Ir button), 

2) 定义 一 个 Context 字段 (如 BUTTON VIS)， 该 字段 的 信息 包含 每 个 单元 格 的 可 见 性 。 
分 配 这 一 字段 到 按钮 Ir_button: 


lr button-> set visible fieldname (BUTTON VIS"). 


3) TEXETRHLIT] I úa 28 FJ 9] CHH Ir column): 


Ir column - > set cell editor (Ir button). 


这 意味 着 ，BUTTON VIS 字段 确定 在 该 列 的 单元 格 lr column 按钮 是 可 见 的 。 
示例 : 
LOOP AT EL ELEMENTS INTO EL ELEMENT. 


EL ELEMENT--GET ATTRIBUTE( EXPORTING NAME -'CARRID' 
IMPORTING VALUE - LWA SFLIGHT-CARRID ). 


CLEAR LWA SFLIGHT-BUTTON VIS. 
IF LWA SFLIGHT-CARRID = 'LH'. 


LWA SFLIGHT-BUTTON VIS = '02'."c] wd table column=>e cell design. 
ENDIF. 
APPEND LWA SFLIGHT TO T SFLIGHT. 
ENDLOOP. 
LR BUTTON->SET VISIBLE FIELDNAME( BUTTON VIS' ). 


fi F] ub S 4e TE E Je E BRL CRAT: 

e 用 于 TEXT VIEW 字体 类 型 的 设置 (SET DESIGN 或 SET DESIGN FIELDNAME). 

e 一 个 选 定 切换 按钮 图 形 的 设置 (SET CHECKED IMAGE SOURCE 或 SET _ 
CHECKED IMG SRC FIELDNAME). 

e 用 村 ProgressIndicator 的 斥 寸 进度 条 的 设 定 (SET PERCENT VALUE 或 SET_ 
PERCENT VALUE FIELDNAME )。 

在 该 过 程 中 的 选项 依赖 于 单元 格 编辑 器 的 UI 76038 ADT, 


6.3.2 ALV 输出 、 列 和 单元 格 的 大 小 


默认 情况 下 ，ALV 输出 ， 列 和 行 的 大 小 取 雇 于 其 内 容 。 这 意味 看 : 

e 每 一 列 的 宽度 至 少 为 最 宽 的 单元 格 的 宽度 。 

€ ALV 输出 宽度 是 所有 列 宽 度 的 和 。 

e 每 一 行 的 高 度 全 少 为 最 高 的 单元 格 的 高 度 。 

程序 员 通 过 指定 所 需 的 宽度 可 以 轻松 地 增加 ALV 输出 和 列 的 宽度 。 然 而 将 宽度 减 小 是 不 
容易 的 。 首 先 ， 需 要 冻结 ALV 得 出 的 布局 ， 这 会 分 配 所 有 列 相 同 的 宽度 ， 然后， 指定 所 十 的 
每 一 列 的 宽度 。 可 以 进行 以 下 设置 ， 限 定 各 个 领域 的 大 小 : 改变 宽度 、 改 变 高 度 、 旋 结 表格 
布局 。 
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注 : 只 能 控制 使 用 它们 的 内 容 (如 使 用 的 图 形 的 尺寸 或 多 行文 本 ) 的 行 的 高 度 。 


(1) 改变 宽度 
要 改变 一 个 区 域 的 宽度 ， 使 用 该 区 域 类 的 方法 ， 见 表 6-36. 


表 6-36 
的 单元 格 编辑 器 ) 
BUE (Image) SET WIDTH & SET. WIDTH_ 
值 比较 ( Value Comparison) 
取得 ALV 输出 的 宽度 IF SALV WD TABLE SETTINGS 
取得 列 宽 CL SALV WD COLUMN GET WIDTH 


取得 商业 图 表 的 宽度 IF SALV WD GRAPHIC SETTINGS 


取得 单元 格 的 宽度 (只 有 在 上 面 的 单元 格 编辑 器 ) 


GET _ WIDTH 或 GET_ WIDTH 
FIELDNAME 


(2) 改变 高 度 

使 用 在 一 个 时 间 段 内 显示 的 行 的 数量 来 指定 ALV 输出 的 高 度 。 

E: 如 果 数 据 记 录 数 小 于 可 见 行 数 ， 则 空 行 会 自动 添加 到 ALV 输出 底部 。 可 以 指定 没有 
空 行 可 以 追加 ， 则 ALV 输出 的 高 度 会 根据 本 身 的 数据 记录 数 加 以 调整 。 


要 做 到 这 一 点 ， 可 以 使 用 接口 类 IF_ SALV WD TABLE SETTINGS (实现 类 CL SALV 
WD CONFIG TABLE) 的 方法 ， 见 表 6-37. 


表 6-37 
J J Bë J ”法 
指定 可 见 行 数 SET VISIBLE ROW COUNT 
取得 可 见 行 数 GET VISIBLE ROW COUNT 
jË ART SET DISPLAY EMPTY ROWS 
AEREI TIT GET_DISPLAY EMPTY ROWS 


注 : 要 显示 所 有 内 部 数据 表 中 的 数据 记录 ， 将 可 见 行 数 设置 为 -1。 


(3) 冻结 表 布 局 
冻结 ALV 输出 的 布局 可 以 用 来 使 列 的 宽度 罕 于 它们 内 容 的 长 度 。 
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要 做 到 这 一 点 ， 可 以 使 用 接口 类 IF SALV WD TABLE SETTINGS (实现 类 CL SALV 
WD CONFIG TABLE) 的 方法 ， 见 表 6-38. 


表 6-38 
E 能 To XA 
冻结 表格 布局 SET FIXED TABLE LAYOUT 
检查 表格 布局 是 否 被 冻结 GET FIXED TABLE LAYOUT 


6.3.3 个 别 区 域 的 可 见 性 
可 以 显示 或 隐藏 ALV 输出 的 不 同 区 域 。 
注 : 如果 一 个 区 域 是 在 一 个 不 可 见 的 区 域内 ， 则 该 区 域 也 是 不 可 见 的 。 


可 以 显示 和 隐藏 以 下 几 个 方面 的 整个 区 域 或 某 个 区 域内 的 个 别 区 域 ， 见 表 6-39。 
整个 ALV 输出 。 

单个 列 。 

作为 单元 格 编辑 器 和 单元 格 变 式 的 每 个 UI 元 素 。 

整个 工具 栏 及 所 有 功能 。 

在 工具 栏 上 个 别 标准 ALV 功能 的 UI 元 素 。 

ALV 输出 中 页 眉 区 域 的 设计 对 象 。 

ALV 输出 中 页 脚 区域 的 设计 对 象 。 


注 ， 若 要 隐藏 其 中 的 对 和 象 ， 如 ALV 输出 的 页 眉 或 列 标题 ， 则 必须 删除 相关 的 对 象 。 


表 6-39 
整个 ALV 输出 IF SALV WD TABLE SETTINGS 
单个 列 CL SALV WD COLUMN 
SET VISIBLE 
作为 单元 格 编辑 器 和 单 、 GET VISIBLE 
zs i CL SALV WD UIE J UL 元 素 的 基 类 一 
元 格 变 式 的 每 个 UI 元 素 uH z: 2 (所 有 的 元 素 的 FSR) 
整个 工具 栏 及 所 有 功能 IF SALV WD FUNCTION SETTINGS 
ALV fj Ti Je ps re 
exe 答 出 中 页 忆 区 域 的 IF SALV WD TABLE SETTINGS SET TOP OF LIST VISIBLE 
设计 对 象 mme DS 
ALV uir oc pcs 
T 答 出 中 页 脚 区 域 的 IF SALV WD TABLE SETTINGS SET END OF LIST VISIBLE 
设计 对 象 icd iE 
在 工具 栏 上 个 别 标准 SET -standard function» ALLOWED 
ALV 功能 的 UI 7628 A ER E IS_<standard function> ALLOWED 


6.3.4 ALV 输出 、 列 和 单元 格 的 颜色 


可 以 指定 各 个 领域 的 ALV 输出 的 颜色 。 有 以 下 选项 可 供 选择 : 
D ALV 输出 。 可 以 选择 下 列 变 量 : 
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e 标准 闫 色 分 配 。 所 有 的 行 和 列 具有 相同 的 闫 色 。 

e ^15. ALV 输出 行 在 明 与 暗 之 间 交 蔡 。 

e 和 透明。 背景 是 透明 的 。 各 个 单元 格 之 间 没 有 显示 网 格 线 。 

2) 列 。 可 以 为 一 列 更 改 背景 颜色 。 可 以 使 用 预先 配置 (pre-configured) KE XIE 

3) 单元 格 变 式 。 可 以 指定 单元 格 变 式 的 背景 闫 色 。 可 以 使 用 预先 配置 (pre-configured) 
的 语义 汤色 。 


注 : 如 采写 保护 (write-protection ) 被 激活 ， 则 用 尸 可 以 使 用 这 些 选 项 。 


4) 单元 格 。 可 以 改变 单元 格 编辑 器 TEXT. VIEW 的 颜色 ， 也 是 唯一 可 以 改变 颜色 的 UI 
元 素 。 可 以 选择 使 用 背景 和 文字 颜色 的 组 合 。 

5) 工具 栏 。 可 以 选择 下 列 变量 : 

e 标准 颜色 分 配 。 

e 彩色 。 

e Hj. 


VALERE IR Jy IAIK 6-40. 


表 6-40 
" SET DESIGN 
ALV 输出 IF SALV WD TABLE SETTINGS GET DESIGN 


SET CELL DESIGN 
s GET CELL DESIGN 
SET CELL DESIGN 或 
SET CELL DESIGN FIELDNAME 
GET CELL DESIGN 或 
GET CELL DESIGN FIELDNAME 
SET SEMANTIC COLOR 或 
SET SEMANTIC COLOR FIELDNAME 
GET SEMANTIC COLOR 或 
GET SEMANTIC COLOR FIELDNAME 


I SET DESIGN 
E ` 
工具 栏 IF SALV WD FUNCTION SETTINGS GET DESIGN 
` Ú 
6.3.5 ”文本 属性 


可 以 在 ALV 输出 中 单个 区 域内 指定 如 下 文本 的 显示 方式 ， 见 表 6-41. 

1) fEAUIIZK^POSE 2727 3X e 

2) 一 个 单元 格 变 式 的 水 平 对 并 方式 。 

3) 在 单元 格 中 的 字体 大 小 和 风格 。 

该 功能 只 适用 于 单元 格 编辑 器 TEXT VIEW。 在 这 里 ， 可 以 选择 使 用 预先 设 定 的 
格式 。 

e 在 单元 格 中 换行 。 

该 功能 仅 适 用 于 细胞 编辑 器 TEXT VIEW, LINK TO ACTION 和 LINK TO URL, 如果 
文本 包含 字符 ， 则 允许 一 个 换行 符 〈 如 空格 和 连 字 符 )， 文 本 可 以 显示 为 多 行 。 

e 一 个 单元 格 内 字体 的 黄色 。 

e 页 眉 或 页 脚 区 域 中 设计 对 象 的 对 齐 、 罕 体 大 小 、 字 体 样 式 。 


单元 格 变 式 CL SALV WD CV STANDARD 


单元 格 CL SALV WD UIE TEXT VIEW 
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X 6-41 


l SET_H_ALIGN 
DES CL SALV WD COLUMN GET H ALIGN 


gu PIMUM SET H ALIGN 
单元 格 变 式 对 齐 CL SALV WD CV STANDARD GET H ALIGN 


SET DESIGN 或 
ES SET DESIGN FIELDNAME 
x L SALV WD UIE TEXT VIE - 一 一 
单元 格 字体 大 小 和 风格 CL SALV WD UIE - |. VIEW GET DESIGN 或 
GET DESIGN FIELDNAME 


SET WRAPPING 或 
CL SALV WD UIE TEXT VIEW 3 


ga ja SET WRAPPING FIELDNAME 
L SAL D UIE LINK TO ACTI = 一 一 
单元 格 中 换行 CL SALV WD UIE LINK TO ACTION GET WRAPPING 或 


GET WRAPPING FIELDNAME 


CL SALV WD UIE LINK TO URL 


6.3.6 Jf TZ IRIS 


在 ALV 输出 中 可 以 定义 是 否 要 显示 或 隐藏 列 和 行 之 间 的 网 格 。 可 以 选择 下 列 变 量 : 

e 仪 显示 列 之 间 的 网 格 。 

e (o zB. 

e 显示 行列 之 间 的 网 格 。 

e 不 显示 网 格 。 

可 以 使 用 接口 类 IF SALV WD TABLE SETTINGS (实现 类 CL SALV WD CONFIG 
_TABLE) 的 方法 ， 见 表 6-42. 


表 6-42 


功 能 3. X5 
显示 或 隐藏 Lines SET GRID MODE 


检查 Lines 是 否 显示 或 隐藏 GET GRID MODE 
6.3.7” 树 状 层次 结构 表 


ALV 输出 可 以 作为 一 个 层次 显示 ， 其 步骤 如 下 : 

e 指定 层次 结构 中 的 列 。 可 以 指定 一 个 或 多 个 列 的 层次 结构 列 。 

@ 指定 显示 类 型 。 可 以 定义 ALV 输出 的 层次 结构 。 

也 可 以 指定 所 有 的 层级 为 可 扩展 的 。 默认 情况 下 ， 当 ALV 输出 显示 时 只 有 行 的 层次 上 是 
可 见 的 。 

(1) 层次 结构 

作为 层次 结构 显示 ALV 输出 中 列 上 具有 以 下 的 效果 : 

1) ALV 输出 会 自动 根据 所 有 层级 列 进行 排序 。 

2) 默认 情况 下 ， 排 序 顺序 〈 层 级 的 序列 ) 由 列 对 象 序列 确定 。 程 序 员 可 以 用 以 下 不 同 的 
方式 更 改 层级 的 顺序 : 

e 更 改 〈 层 次 ) 列 的 位 置 。 

e 更 改 用 于 结构 列 顺序 排序 字段 的 层次 。 

3) 定义 的 层次 结构 列 的 列 不 会 以 通常 的 形式 显示 。 相 反 ， 所 有 的 层次 结构 的 所 有 列 的 值 
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一 起 被 显示 在 第 一 列 中 。 该 值 根据 它 所 属 的 层级 缩 进 。 

4) 一 个 层次 结构 的 第 一 列 中 的 值 有 一 个 小 的 箭头 图 标 。 用 户 可 以 利用 这 个 稍 头 图 标 显 示 
或 隐藏 所 有 较 低 级 别 的 数据 记录 。 

可 以 指定 列 中 的 数据 中 最 后 的 层次 结构 不 作为 一 个 带 有 一 个 箭头 图 标 节 点 显示 ， 可 用 一 
个 点 作为 叶子 显示 。 

5) 默认 情况 下 ， 只 有 较 高 层次 级 别 的 行 显示 。 较 低层 级 不 会 被 扩展 ， 因 此 不 显示 。 

6) 第 一 列 的 层次 结构 不 是 一 个 类 CL SALV WD COLUMN 的 对 象 实例 。 

7) 列 的 列 标题 、 每 个 层次 结构 列 的 列 标题 被 列 在 一 起 。 

8) 层次 列 或 它们 的 值 〈 因 为 本 号 是 不 显示 的 列 ) 是 不 能 隐藏 的 。 

k: 页面“ 设置” 对 话 框 的 “Column Selection” 选 项 卡 中 会 显示 绿色 的 层次 结构 中 的 列 。 
用 户 不 能 将 它们 设 为 隐藏 列 。 

(2) 指定 层次 结构 中 的 列 

要 定义 层次 结构 中 的 列 可 使 用 接口 类 IF SALV WD COLUMN HIERARCHY (实现 类 
CL SALV WD COLUMN) 的 方法 ， 见 表 6-43. 


表 6-43 
E 能 J ”法 
指定 层次 结构 中 的 列 SET HIERARCHY COLUMN 
检查 列 是 个 是 一 个 层次 结构 列 IS HIERARCHIY COLUMN 


(3) 指定 显示 类 型 


定义 ALV 输出 为 一 个 层次 ， 从 而 确定 显示 的 类 型 ， 可 以 使 用 接口 类 IF_SALV_WD_ 
TABLE SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-44. 


表 6-44 
JJ 能 J dE 
指定 显示 类 型 SET DISPLAY TYPE 
取得 显示 类 型 GET DISPLAY TYPE 


(4) 扩展 较 低 层级 

对 于 层次 结构 显示 ，ALV 输出 第 一 次 显示 时 加 载 的 所 有 数据 。 大 量 的 数据 可 能 会 导致 
加 载 时 间 长 。 默认 情况 下 ,只 有 行 的 层次 被 显示 出 来 。 较 低层 级 不 会 被 扩展 ， 因 此 不 显示 。 

程序 员 也 可 以 指定 扩大 所 有 的 层级 。 要 做 到 这 一 点 ， 可 以 使 用 接口 类 IF_SALV_WD_ 
TABLE HIERARCHY (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-45. 


表 6-45 
X Ë 
展开 所 有 的 层级 SET EXPANDED 


检查 是 否 所 有 的 层级 将 扩大 IS EXPANDED 


CC 
过 
N 
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(5) 显示 层次 结构 列 数 据 为 叶 (Leaf) 

要 在 第 一 列 的 层次 结构 中 显示 最 后 的 层次 结构 中 的 数据 列 作 为 叶 ， 使 用 接口 类 
IF SALV WD TABLE HIERARCHY (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 
表 6-46. 


表 6-46 
Yy 能 六 ”法 
显示 数据 的 最 后 层次 结构 列 作 为 叶 SET LAST HIER COLUMN AS LEAF 
检查 最 后 的 层次 结构 的 数据 列 是 否 被 显示 为 一 个 叶 IS LAST HIER COLUMN AS LEAF 


6.3.8” 表 数据 作为 业务 图 形 输 出 


ALV 可 以 作为 业务 图 形 显示 ALV 输出 的 数据 。 用 于 业务 图 形 时 可 以 进行 以 下 设置 
e 显示 业务 图 形 。 

e 指定 数据 使 用 。 

@ 更 改 业务 图 形 的 外 观 。 

e 允许 或 禁止 业务 图 表 显 示 。 


NS 如 果 允 许 用 户 显示 数据 的 业务 图 形 ， 则 可 以 从 一 系列 的 图 表 类 型 中 选择 。 大 多 数 用 
户 选择 立 式 条 形 图 或 条 形 图 来 显示 ALV 输出 的 数据 。 


(1) 显示 业务 图 形 

可 以 指定 当 ALV 输出 时 是 否 显示 业务 图 形 。 可 以 选择 下 列 选 项 : 

e HR. 

e 显示 表 和 业务 图 形 。 

e 仪 显示 业务 图 形 。 

要 做 到 这 一 点 ， 可 使 用 接口 类 IF SALV WD TABLE SETTINGS (实现 类 CL SALV 
WD CONFIG TABLE) 的 方法 ， 见 表 6-47。 


表 6-47 
功 能 方 ” 法 
指定 显示 的 类 型 SET DISPLAY AS 
取得 显示 的 类 型 GET DISPLAY AS 


(2) 指定 数据 使 用 

业务 图 形 显示 的 数据 主要 取决 于 是 否 以 及 在 哪些 列 进行 计算 : 

1) 如 末 不 进行 任何 计算 : 

e 第 一 列 的 字母 数 子 类 型 的 数据 用 于 包含 图 表 特 性 的 坐标 轴 。 立 式 条 形 图 通 第 是 XX 轴 ， 


条 形 图 通常 是 Y HH. 
e 第 一 列 的 数值 类 型 数据 用 于 包含 关键 数据 的 坐标 轴 。 立 式 条 形 图 通常 是 Y B. AE 
Jd XE XH. 


2) 如 条 进行 计算 : 
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e 以 字母 数字 的 类 型 数据 的 第 一 列 用 于 包含 网 表 的 特性 的 坐标 轴 。 

e 在 X 轴 上 显示 的 涉及 计算 的 每 一 列 ， 用 于 包含 数字 关键 数据 的 坐标 轴 。 

3) 如 果 生 成 的 中 间 结 果 : 

e 这 是 以 每 一 列 为 一 个 标准 的 中 间 结 果 显 示 的 轴 ， 它 包含 图 表 的 特性 。 如 果 指 定 一 个 以 

上 的 标准 《多 个 列 )， 则 标准 的 组 合 被 显示 。 

e 坐标 轴 上 每 列 涉及 计算 的 ， 包 含 数字 关键 数据 的 图 表 被 显示 。 

可 以 通过 移动 相应 列 到 ALV 输出 的 左边 指定 哪些 数据 将 要 被 显示 在 业务 图 形 中 , 或 通过 
列 的 计算 ， 但 不 影响 业务 图 形 的 内 容 。 

(3) 改变 业务 图 形 的 外 观 

可 以 指定 一 个 业务 图 形 的 外 观 : 

e 指定 业务 图 形 的 维度 。 

e 指定 业务 图 形 的 类 型 。 

e 指定 业务 图 形 的 大 小 。 

1) 维度 。 

可 以 为 业务 图 形 设置 以 下 维度 : 

e 2D， 如 图 6-3 所 示 。 


E 


D occupied 国 piste x zm EN 
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e 3D, WB] 6-5 所 示 。 


2) 图 表 类 型 。 

可 以 从 以 下 的 图 表 类 型 中 进行 选择 : 

面积 图 (Area chart)。 

条 形 图 (Bar chart). 

立 式 条 形 图 (Vertical bar chart). 

RE] (Doughnut chart). 

折线 图 (Line chart). 

DRE (Pie chart). 

分 饼 图 (Split pie chart). 

堆积 面积 图 (Stacked area chart). 

堆积 条 形 图 (Stacked bar chart). 

堆积 立 式 条 形 图 (Stacked vertical bar chart). 
e 堆积 折线 图 (Stacked line chart). 
要 改变 业务 图 形 的 外 观 ， 使 用 接口 类 IF SALV WD GRAPHIC SETTINGS (实施 类 

CL SALV WD COLUMN?) 的 方法 ， 见 表 6-48. 


表 6-48 

JJ 能 PNE - 
指定 的 商业 图 形 的 尺寸 SET DIMENSION 
获取 业务 的 尺寸 图 形 GET DIMENSION 
指定 高 度 的 商业 图 表 SET HEIGHT 
获得 高 度 的 商业 图 表 GET HEIGHT 
指定 图 表 类 型 SET_TYPE 
获得 图 表 类 型 GET TYPE 
指定 业务 宽度 的 图 形 SET WIDTH 
获得 宽度 的 商业 图 表 GET WIDTH 


(4) 允许 或 不 允许 作为 业务 图 形 显 示 
默认 情况 下 ， 允 许 用 户 在 数据 显示 ALV 输出 业务 图 形 。 在 工具 栏 的 下 拉 列 表 框 中 ， 用户 
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可 以 从 以 下 选项 中 进行 选择 : 

e 只 显示 为 表 。 

e 显示 表 和 业务 图 形 。 

e 只 显示 业务 图 形 。 

可 以 茶 止 用 户 显 示 数 据 的 业务 图 形 。 要 做 到 这 一 点 ， 可 以 使 用 接口 类 IF SALV 
WD STD FUNCTIONS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 见 表 6-49, 


表 6-49 
JJ Bé Hw 
允许 显示 图 形 业 务 SET DISPLAY AS ALLOWED 
检查 是 否 允 许 商业 图 表 显 示 IS DISPLAY AS ALLOWED 


6.3.9 "üt Pel CK 


如 果 没 有 可 用 的 数据 ， 则 可 以 在 ALV 输出 的 区 域 显示 指定 的 文本 。 
要 为 室 ALV 输出 显示 替换 文本 时 使 用 接口 类 IF SALV WD TABLE SETTINGS( 实 现 类 
CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-50. 


表 6-50 
Yy 能 Ao dE 
TEERAA SET EMPTY TABLE TEXT 
THNOCAN GET EMPTY TABLE TEXT 


64 ”预定 义 标准 MV 功能 


程序 员 可 以 在 应 用 程序 中 预定 义 ALV 在 屏幕 上 的 输出 布局 , 当 用 户 调 用 应 用 程序 时 该 布 
局 即 被 输出 。 访 操作 涉及 数据 本 映 及 设计 方面 ， 因 此 程序 员 可 以 编辑 该 表 中 的 数据 以 定义 显 
示 方 式 。 相 应 功能 如 下 : 

e HEF. 

e 过 小数 据 。 

e i. 
e jJ. 
e 导出 为 外 部 格式 数据 。 
6.4.1 排序 


程序 员 可 以 根据 特定 的 规则 进行 排序 ， 更 改 数据 记录 的 顺序 ， 进 行 ALV 输出 。 可 
以 指定 哪些 字段 的 值 按 池 母 顺 序 或 数字 顺序 〈 按 大 小 ) 进行 排序 ， 从 而 确定 序列 中 的 所 
有 行 。 

开发 者 可 以 进行 以 下 排序 设置 : 

e 创建 、 获 取 、 删 除 排序 设置 〈 排 序 条 件 )。 
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e 设置 排序 方向 和 排序 顺序 

e 按照 相同 的 值 分 组 。 

e 强制 某 个 字段 的 排序 。 

e 按照 选中 某 一 列 局 用 排序 。 

e 根据 另 一 个 字段 的 值 对 一 个 字段 结合 排序 。 
e 隐藏 和 显示 排序 标签 页 


NS 程序 员 可 以 使 用 数字 列 的 值 进行 合计 。 默 认 情 况 下 ， 所 有 列 的 值 均 可 用 于 此 功能 
除了 合计 之 外 ， 如 果 需 要 中 间 小 计 结 果 ， 则 -o BITHE. ARET 计 结果 
ALV 可 以 按照 列 的 默认 排序 情况 自动 生成 小 计 结 果 


(1) 创建、 获取、 删除 排序 设置 
排序 是 ALV 输出 中 一 个 字段 的 属性 。 创 建 、 获 取 或 删除 字段 排序 条 件 ， 可 以 使 用 接口 类 
IF SALV WD SORT (实施 类 CL SALV WD FIELD) 中 的 方法 ， 见 表 6-51. 


表 6-S1 
Jj 能 方 ”. 法 
取得 排序 条 件 GET SORT _ RULE 
创建 排序 条 件 CREATE SORT RULE 
删除 排序 条 件 DELETE SORT _ RULE 


字段 的 排序 条 件 对 象 是 类 CL SALV WD SORT RULE 的 对 象 。 


MES 如 果 指 定 的 ALV 输 出 是 一 个 新 的 结构 ， 则 新 的 数据 内 表 的 所 有 字段 的 排序 条 件 会 自 
动 删除 。 


(2) 设置 排序 方向 和 排序 顺序 

对 于 每 个 单独 的 排序 条 件 ， 可 以 指定 是 否 要 排序 及 按 字段 值 升 序 CA. B. C) 或 降序 〈C、 
B. AO 排序 〈 排 序 方 向 )。 

如 果 通 过 改变 由 多 个 字段 排序 更 改 ALV 输 出 ， 则 输出 结果 依赖 于 排序 序列 中 的 哪些 字段 。 
默认 情况 下 ， 该 字段 在 序列 中 被 排序 以 生成 排序 条 件 。 程 序 员 可 以 更 改 此 序列 。 要 做 到 这 一 
点 ， 可 以 为 排序 顺序 的 字段 指定 一 个 位 置 编号 (或 排序 条 件 )。 

否 要 更 改 排 序 条 件 的 排序 方 辐 或 排序 顺序 ， 则 可 以 使 用 类 CL SALV WD SORT RULE 
中 的 方法 ， 见 表 6-52。 


表 6-52 
JJ 能 EE 
指定 排序 方向 SET SORT ORDER 
取得 排序 方向 GET SORT ORDER 
设置 排序 顺序 领域 内 的 位 置 SET SORT POSITION 
取得 排序 顺序 领域 内 的 位 置 GET SORT POSITION 


(3) 按照 相同 的 值 分 组 
棱 认 情况 下 ， 在 一 个 排序 字段 的 排序 的 序列 中 ，ALYV 输出 的 值 是 相同 的 。ALYV 上 月 动 将 值 
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进行 分 组 。 可 以 指定 一 个 值 出 现在 每 一 行 ， 即 使 这 个 值 不 会 改变 。 要 做 到 这 一 点 ， 使 用 接口 
类 I 下 SALV WD SORT (实现 类 CL SALV WD FIELD) 的 方法 ， 见 表 6-53. 


表 6-53 
JJ 能 43 2 
创建 /删除 分 组 SET GROUPING ALLOWED 
检查 是 否 对 值 进 行 分 组 IS GROUPING ALLOWED 


(A) 强制 茶 个 字段 的 排序 

可 以 明确 地 茶 止 一 个 字段 进行 排序 ， 这 具有 以 下 效果 : 

e 相关 领域 不 再 显示 的 “Settings” 对 话 框 中 的 “排序 ”选项 卡 页 面 。 

e 如 果 想 通过 用 户 单 击 列 标题 进行 排序 ， 则 该 功能 不 可 用 ， 禁 止 排序 的 列 的 第 头 图 标 被 

BEER o 

e 如 果 在 应 用 程序 中 为 这 一 字段 定义 了 一 个 排序 条 件 ， 则 这 种 状况 不 影响 ALV 输出 。 

要 禁止 某 个 字段 的 排序 ， 使 用 接口 类 IF SALV WD SORT (实现 类 CL SALV WD. 
FIELD) 的 方法 ， 见 表 6-54. 


表 6-54 
JJ 能 ik 
禁止 排序 SET SORT ALLOWED 
检查 是 否 允 许 排序 IS SORT ALLOWED 


(5) 按照 选中 某 一 列 局 用 排 厅 

ALV 输出 中 的 列 标题 中 可 以 显示 小 第 头 图 标 。 用 户 可 以 使 用 这 些 第 头 图 标 将 列 按 升序 或 
降序 进行 排序 。 

也 可 以 指定 按 一 列 排序 ， 及 使 用 《Crtl》 键 添加 多 个 列 进行 排序 。 

为 了 使 用 户 能 够 通过 单 击 列 标题 进行 排序 ， 可 以 使 用 接口 的 类 IF SALV WD STD 
FUNCTIONS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-55. 


表 6-55 
功 能 HÀ 3k 
显示 列 标题 中 的 箭头 图 标 SET SORT HEADERCLICK ALLOWED 
检查 是 否 第 头 图 标 显示 在 列 标题 中 IS SORT HEADERCLICK ALLOWED 


为 了 使 用 户 能 够 通过 单 击 列 标题 的 多 个 列 进行 排序 ， 可 以 使 用 接口 类 F_SALV_WD_ 
TABLE SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-56. 


表 6-56 
功 能 2p. A 
局 用 多 个 列 的 排序 SET MULTI COLUMN SORT 
检查 是 否 按 多 个 列 排序 GET MULTI COLUMN SORT 


(6) 根据 为 一 个 字段 的 值 对 一 个 字段 结合 排序 
如 果 东 字段 本 映 不 返回 所 需 的 结果 ， 则 可 以 指定 该 子 段 使 用 当前 子 段 进行 结合 排序 。 要 
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做 到 这 一 点 ， 可 以 使 用 接口 类 IF SALV WD COLUMN SERVICE REF (实施 类 CL SALV 
WD COLUMND ) 的 方法 ， 见 表 6-57. 


表 6-57 
功 能 J ”法 
指定 其 他 字段 的 字段 名 SET SORT FIELDNAME 
获取 其 他 字段 的 字段 名 GET SORT FIELDNAME 


6.4.2 ”过 小 大 


使 用 过 滤器 ， 可 以 限制 ALV 输出 显示 的 数据 记录 。 要 做 到 这 一 点 ， 可 以 在 一 个 特定 的 字 
段 中 指定 条 件 的 数据 记录 ， 以 满足 要 显示 或 过 小 挥 数据 。 

可 以 对 过 滤器 对 象 进行 以 下 设置 : 

e 创建 、 获 取 或 删除 字段 中 的 过 滤 条 件 。 

e KEMERE. 

e iioc 

WEZ IEEE. 

e A e 段 的 值 过 滤 。 

e 在 工具 栏 上 的 “过 滤器 ”设置 页 面 中 隐藏 或 显示 过 滤 标 签 页 。 

(1) 创建 、 获 取 或 删除 字段 中 的 过 滤 条 件 

不 像 排序 条 件 ， 程 序 员 可 以 为 每 个 字段 创建 无 限 的 过 滤 条 件 。 


VS 程序 员 只 可 以 对 没有 禁止 的 列 创建 过 滤 条 件 。 


过 小 是 ALV 输出 中 一 个 字段 的 属性 。 创 建 、 获 取 或 删除 字段 的 过 滤 条 件 ， 可 以 使 用 接口 
类 IF SALV WD FILTER (实现 类 CL SALV WD FIELD) 的 方法 ， 见 表 6-58. 


表 6-S8 
Jj 能 m ws 
获取 特定 的 过 小 器 条 件 GET FILTER RULE 
设 定 一 个 字段 的 所 有 过 滤 条 件 GET FILTER RULES 
创建 一 个 过 滤 条 件 CREATE FILTER RULE 
删除 一 个 特定 的 过 滤器 条 件 DELETE FILTER RULE 
删除 所 有 字段 中 的 过 滤 条 件 DELETE FILTER RULES 


一 个 对 象 的 类 CL SALV WD FILTER RULE 代 表 一 个 字段 的 过 滤 条 件 。 


: 如 果 用 一 个 新 的 结构 分 配 一 个 新 的 数据 表 到 ALV 输 出 ， 则 所 有 字段 的 所 有 过 滤器 条 
"ad r 动 删除 。 
(2) YAT 
过 滤 桥 的 条 件 包括 以 下 内 容 : 
1) 检 碍 行 的 比较 值 。 比 较 值 可 以 是 一 个 单独 的 值 或 范围 。 用 户 角 上 度 输 入 的 是 下 限 的 值 
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(LOW VALUED, fEA—^3&Bb H UN ERE CHIGH. VALUE). 

2) 比较 字段 值 和 比较 值 大 小 操作 。 使 用 这 个 规范 的 ， 用 户 可 以 指定 单元 格 的 值 和 比较 值 
ZLAR CHUA TF. zJ kon o, 

3) 包含 或 排除 。 使 用 这 个 规范 的 ， 可 以 指定 是 否 显示 不 符合 条 件 的 行 。 

要 更 改 设置 的 过 滤 条 件 ， 可 以 使 用 类 CL SALV WD FILTER RULE 方法 ， 见 表 6-59. 


表 6-59 
功 能 对 xA 
指定 比较 值 〈 下 限 值 ) SET LOW VALUE 
取得 比较 值 (下 限 值 ) GET LOW VALUE 
指定 比较 范围 的 上 限 值 SET HIGH VALUE 
取得 比较 范围 的 上 限 值 GET HIGH VALUE 
指定 比较 操作 SET OPERATOR 
获得 比较 操作 GET OPERATOR 
指定 包含 或 排除 SET INCLUDED 
取得 包含 或 排除 GET INCLUDED 


(3) 忽略 大 小 写 

默认 情况 下 ， 当 过 滤 条 件 碍 找 数据 记录 时 ， 过 滤 需 区 分 大 小 写 。 当 用 户 输入 比较 值 时 必 
须 完全 正确 地 输入 值 ， 以 获得 所 需 的 结果 。 

可 以 设置 忽略 大 小 写 。 要 做 到 这 一 点 ， 可 以 使 用 接口 类 IF SALV WD FIELD 
SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-60. 


表 6-60 
Yy 能 T 3 
忽略 大 小 写 SET FILTER IGNORING CASE 
检查 是 否 忽 略 大 小 写 IS FILTER IGNORING CASE 


(4) 设 定 一 列 禁 止 过 渡 

可 以 明确 地 禁止 某 个 字段 的 过 滤 。 这 具有 以 下 效果 : 

e 如 果 ALV 输出 被 过 滤 ， 则 过 滤器 行 会 自动 显示 ， 可 以 看 到 当前 为 每 列 设置 的 过 滤 。 用 

户 可 以 快速 输入 过 滤 条 件 。 

e 如 果 不 人 允许 在 一 个 字段 中 过 滤 ， 则 过 滤器 中 的 行 的 相应 单元 格 是 空 的 并 且 不 可 输入 。 

e 在 “设置 ”对 话 框 中 ,“ 往 选 器 ”选项 卡 页 面 中 的 相应 列 不 再 可 用 。 

e 如 果 在 应 用 程序 中 定义 了 这 一 字段 的 过 滤 条 件 ， 则 过 滤 条 件 对 ALV 输出 没有 影响 。 

要 禁止 某 个 字段 的 第 选 ， 可 使 用 接口 类 IF SALV WD FILTER (实现 类 CL SALV 
WD FIELDO 的 方法 ， 见 表 6-61。 


xk 6-61 
Ij 能 Ao dE 
不 允许 字段 过 滤 SET FILTER ALLOWED 
检查 字段 是 否 允 许 过滤 IS FILTER ALLOWED 
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(5) 使 用 的 另 一 个 字段 的 值 过 滤 

可 以 指定 一 个 字段 ， 根 据 该 字段 对 当前 字段 进行 过 泪 。 如 有 果 该 字段 不 能 返回 所 需 的 丝 
或 者 需要 过 于 复杂 的 输入 ， 则 可 以 使 用 接口 类 正 SALV W D COLUMN SERVICE REF (E 
施 类 CL SALV WD COLUMN 的 ) 的 方法 ， 见 表 6-62. 


表 6-62 
Yy 能 J dE 
指定 字段 名 称 的 另 一 字段 SET FILTER FIELDNAME 
获取 另 一 字段 的 字段 的 名 称 GET FILTER FIELDNAME 


643 ”计算 (合计) 


可 以 对 数值 类 型 数据 进行 计算 : 生成 聚合 条 件 ， 计 算 的 结果 显示 在 一 个 单独 的 结果 行 中 。 
般 对 一 个 字段 的 所 有 值 使 用 聚集 计算 的 过 程 中 ， 也 能 够 获得 中 间 结 果 。 要 做 到 这 一 点 ， 

必须 对 ALV 输出 按 一 定 条 件 排序 ， 根 据 排序 结果 将 行 分 组 。 

可 以 进行 以 下 聚合 设置 : 

e 创建 、 获 取 和 删除 聚合 规则 。 

e uxo. 

e 生成 中 间 结 果 。 

e 隐藏 或 显示 肾 合 计算 或 中 间 结 果 的 接口 元 素 。 

可 以 为 一 个 字段 创建 聚合 规则 中 的 最 大 值 。 聚 合 是 ALV 输出 中 一 个 字段 的 属性 。 创 建 、 
获取 或 删除 字段 的 汇聚 规则 ， 使 用 接口 类 IF SALV_WD AGGR (实施 类 CL SALV WD 
FIELD) 的 方法 ， 见 表 6-63. 


表 6-63 
功 能 2. 5 
取得 聚合 规则 GET AGGR RULE 
创建 汇总 规则 CREATE AGGR RULE 
删除 汇总 规则 DELETE AGGR RULE 


一 个 字段 的 聚合 规则 表示 为 类 CL SALV WD. AGGR. RULE 的 一 个 对 象 。 


注 : 如 果 以 一 个 新 的 结构 分 配 ALV 输 出 一 个 新 的 数据 表 , 则 各 个 字段 的 聚合 规则 被 自动 


6.4.3.1 RERE 


可 以 对 字段 值 的 计算 进行 以 下 设置 
e 设置 条 合 关 型 。 

e 局 荀 结 来 行 的 位 置 。 

e 菜 止 和 东 个 字段 的 聚合 。 

(1) 设置 聚合 类 型 


FARR RR) 类 型 可 供 选 择 ; 
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iMi CTotaD: 所 有 的 字段 值 加 在 一 起 。 

最 小 值 (Minimum): 确定 字段 中 的 最 小 值 。 

最 大 值 (Maximum): 确定 字段 中 的 最 大 值 。 

PIJE (Average): 确定 所 有 字段 值 的 几何 平均 值 。 

要 定义 计算 类 型 ， 使 用 类 的 CL SALV WD AGGR RULE 的 方法 ， 见 表 6-64. 


表 6-64 
功 能 À ik 
设置 计算 类 型 SET AGGREGATION TYPE 
取得 计算 类 型 GET AGGREGATION TYPE 


除了 上 面 列 出 的 计算 类 型 ， 也 可 以 决定 数据 记录 的 总 数 。 测 试 结果 将 显示 在 结果 中 排 在 
第 一 个 可 用 的 列 中 。 由 于 该 设置 会 影响 整个 ALV 输出 ， 因 此 可 以 使 用 接口 类 IF_SALV_ 
WD FIELD SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-65. 


表 6-65 
HX 能 J d 
显示 数据 记录 的 数目 SET COUNT RECORDS ENABLED 
检 得 是 否 显示 数据 记录 的 数量 IS COUNT RECORDS ENABLED 


(2) 设置 结果 行 的 位 置 

在 ALV 输出 中 可 以 定义 是 否 显 示 高 于 或 低 于 该 行 中 所 包含 的 计算 中 的 计算 结果 行 。 可 以 
使 用 接口 类 正 SALV WD FIELD SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 
方法 ， 见 表 6-66. 


表 6-66 
E 能 2 WA 
将 结果 行 放 在 数据 记录 之 前 SET AGGR BEFORE ITEMS 
检 得 结果 行 是 否 在 数据 记录 之 前 IS AGGR BEFORE ITEMS 


(3) ZEIEREAT E EC Cr 

默认 情况 下 ， 各 个 数值 类 型 字段 的 数据 都 可 以 聚合 。 如 果 需 要 ， 程 序 员 可 以 禁止 某 个 字 
段 的 聚集 。 这 具有 以 下 效果 : 

e “设置 ”对 话 框 中 没有 对 该 列 计算 的 标签 页 。 

e 即使 在 应 用 程序 中 定义 该 字段 的 汇总 规则 ， 计 算 也 不 进行 。 

要 禁止 字段 的 聚集 功能 , 使 用 接口 类 IF SALV WD AGGR (实施 类 CL SALV WD FIELD) 
的 方法 ， 见 表 6-67。 


表 6-67 
E 能 Jr 3 
禁止 聚集 SET AGGREGATION ALLOWED 
检查 是 否 允 许 聚 集 IS AGGREGATION ALLOWED 


6.4.3.2 ”中 间 结 果 
默认 情况 下 ， 有 字段 中 的 所 有 值 在 聚集 过 程 中 都 可 以 进行 计算 。 同 时 ， 聚 集 还 可 以 生成 中 
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间 结 果 。 当 生成 中 间 结 果 时 ， 将 数据 记录 包含 的 值 进行 分 组 生成 中 间 结 来 ， 并 将 中 间 结 果 显 
示 在 一 个 单独 的 结果 行 。 
要 生成 中 间 结 果 ， 必 须 进行 以 下 设置 : 
e 指定 哪些 字段 值 要 计算 中 间 结 束 ， 可 以 创建 相关 字段 的 聚合 条 件 。 总 的 结 采 显示 在 结 
朱 行 。 
e 指定 哪些 数据 记录 包含 一 个 中 间 结 末 , 将 数据 记录 分 组 , 在 ALV 输出 对 分 组 的 字段 排 
序 ， 该 字段 包 舍 在 中 间 结 和 准则 中 。 
e 要 产生 的 中 间 结 末 ， 需 将 字段 进行 聚集 ， 该 字段 包含 在 中 间 结 条 的 规则 中 。 
e 要 显示 中 间 结 末 ， 需 在 显示 屏 上 激活 中 间 结 来 显示 。 


注 : 产生 中 间 结 果 的 最 常用 的 方法 是 使 用 小 计 。 中 间 结 果 可 用 于 所 有 聚合 类 型 的 中 间 


(1) "BIB RARE 

e 生成 中 间 结 果 。 

e 显示 中 间 结 果 。 

e 指定 级 别 下 的 中 间 结 末 。 

e 设置 结果 行 的 位 置 。 

e 禁用 产生 中 间 结 果 。 

(2) 先决 条 件 

e 已 经 创建 了 至 少 一 个 字段 可 聚合 的 聚合 条 件 。 

e 该 字段 中 间 结 果 的 准则 不 能 被 合并 ， 包 含 一 个 字母 数学 类 型 数据 的 字段 (用 于 分 组 )。 
(3) 生成 中 间 结 果 

要 在 一 个 学 段 已 经 具有 的 聚合 条 件 下 产生 中 间 结 采 , 用 另 一 列 的 字段 创建 一 个 排序 条 件 。 
在 这 种 条 件 下 ， 可 以 指定 是 否 要 生成 中 间 结 来。 要 做 到 这 一 点 ， 可 以 使 用 类 CL _SALV_ 
WD SORT RULE 的 方法 ， 见 表 6-68. 


表 6-68 
JJ 能 Ao dE 
生成 中 间 结 SET GROUP AGGREGATION 
检查 是 否 显示 中 间 结 果 GET GROUP AGGREGATION 


(4) 显示 中 间 结 末 

已 经 完成 所 有 设置 后 ， 要 显示 生成 的 中 间 结 末 ， 必 须 激 活 这 些 中 间 结 果 的 显示 。 要 做 到 
这 一 点 ， 可 以 使 用 接口 类 IF SALV WD FIELD SETTINGS (实现 类 CL SALV WD CON 
FIG TABLE) 的 方法 ， 见 表 6-69. 


表 6-69 
功 Bë A AA 
显示 中 间 结 果 SET GROUP AGGR DISPLAYED 
检 碍 是 否 显 示 中 间 结 果 GET GROUP AGGR DISPLAYED 
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(5) 指定 级 别 下 的 中 间 结 采 

如 果 已 经 定义 了 多 个 字母 数字 字段 的 中 间 结 果 ， 则 该 结果 在 多 个 级 别 小 计 : 中 间 结 末 分 
层 显 示 ， 根 据 级 别 并 标 有 特定 数目 的 点 。 用 户 可 以 使 用 这 些 点 显示 和 隐藏 中 间 结 末 的 条 目 。 
在 应 用 程序 中 ， 可 以 显示 或 隐藏 一 个 或 多 个 级 别 的 小 计 条 目 。 

也 可 以 折 闭 中 间 结 果 : 在 这 一 过 程 中 ,可 以 隐藏 所 有 数据 记录 和 任何 相应 低级 别 的 小 计 。 
只 有 结果 行 小 计 的 最 高 级 别 结果 和 总 计 结 果 行 保持 可 见 。 

对 于 这 些 功能 , 可 以 使 用 接口 类 正 SALV WD FIELD SETTINGS (实现 类 CL SALV WD 
_CONFIG TABLE) 的 方法 ， 见 表 6-70. 


表 6-70 
J Bé I Q 
指定 显示 最 高 级 别 小 计 SET EXPAND LEVEL 
获取 当前 显示 小 计 级 别 GET EXPAND LEVEL 
Jr en qu] zs É SET GROUP AGGR COLLAPSED 
检查 数据 是 否 被 折合 成 中 间 结 果 GET GROUP AGGR COLLAPSED 


(6) 茜 用 产生 中 间 绪 

默认 情况 下 ， 茶 个 字段 合计 的 中 间 结 末 被 目 动 显 示 在 ALV 输出 中 。 所 有 排序 字母 数字 关 
型 数据 的 字段 和 被 解释 为 可 能 的 中 间 结 末 的 计算 准则 ， 从 而 提供 中 间 结 

可 以 至 止 特定 字段 中 间 结 来 的 产生 。 如 果 应 用 程序 在 这 一 字段 产生 中 间 结 来 ， 则 这 些 设 
TOS ALV 输出 没有 影 啊 。 


注 : 用 户 可 以 指定 想 要 的 列 ， 以 显示 中 间 结 果 。 如 果 是 禁止 生成 中 间 结 果 的 字段 ， 则 没 
有 显示 给 用 户 的 特定 列 。 


要 禁止 字段 产生 中 间 结 果 ， 使 用 接口 类 IF SALV WD SORT (实现 类 CL SALV WD ` 
FIELD) 的 方法 ， 见 表 6-71. 


表 6-71 
JJ 能 s. 3 
禁止 生成 中 间 结 SET GROUP AGGREGATION ALLOWED 
检查 是 否 允 许 生 成 中 间 结 果 IS GROUP AGGREGATION ALLOWED 


6.4.4 ”配置 和 个 性 化 ALV 输出 


可 以 配置 Web Dynpro 应 用 , 因此 在 设计 时 指定 呈现 给 用 户 工作 时 的 细节 显示 ， 而 有 些 细 
节 是 不 能 在 设计 时 设 定 的 。 此 外 ， 管 理 员 和 用 户 可 以 在 运行 时 生成 和 保存 目 己 的 设置 ， 调 整 
应 用 程序 的 定制 和 个 性 化 。 

在 ALV 组 件 中 也 有 各 种 选项 修改 了 一 组 标准 的 属性 , 用 户 可 以 根据 上 自己 的 业务 需求 为 日 
己 提供 合适 的 变 式 。 然而 , 与 其 他 的 Web Dynpro 环境 不 同 , 用 户 不 可 以 在 设计 时 使 用 此 配置 。 
在 设计 时 ， 有 可 能 没有 指定 涉及 配置 的 结构 。 出 于 这 个 原因 ， 在 一 般 情况 下 不 能 使 用 应 用 程 


129 


序 配 置 工具 来 配置 ALV 输出 。 

(1) 个 性 化 配置 和 自 定 义 ALV 输出 

1) 个 性 化 : ALV 输出 的 功能 之 一 ， 提 供给 用 户 设 定 视 图 。 在 视图 中 用 户 可 以 保存 列 
结构 、 排 序 条 件 、 沛 选 条 件 和 各 种 显示 选项 信息 。 这 意味 看 用 户 可 以 使 用 其 设置 选项 始 
终 显示 ALV 输出 。 然 而 ， 这 些 配 置 视图 只 提供 给 创建 它 的 用 户 ， 其 他 用 户 无 法 看 到 这 些 
视图 。 

2) 配置 : 应 用 程序 开发 人 员 使 用 ALV 配置 模型 中 的 类 及 方法 既 不 能 创建 也 删除 视图 。 
但 是 ， 他 们 可 以 在 特殊 模式 下 在 ALV 组 件 中 创建 无 限 数量 的 视图 ， 并 交付 这 些 视 图 。 应 用 程 
序 开发 人 员 可 以 将 视图 保存 在 配置 数据 记录 中 ， 通 过 ALV 编程 将 其 传输 和 交付 。 

3) 定制 〈 自 定义 ): 在 客户 的 网 站 中 ， 管 理 员 可 以 改变 他 们 所 提供 的 视图 ， 或 插入 自己 
的 视图 ， 然 后 将 这 些 视图 提供 给 所 有 用 户 客 户 靖 。 


注 : 配置 和 定制 ， 必 须 启 动 应 用 程序 分 别 需要 的 模式 ， 并 在 运行 时 进行 必要 的 设置 。 


(2) 视图 和 ALV 配置 模型 的 数据 结构 

所 有 设置 , 用 户 保 存在 ALV 输出 的 视图 中 , 该 设置 涉及 一 个 特定 数据 结构 的 字段 的 ALV 
配置 模型 。 例 如 ， 如 果 用 户 加 载 男 一 种 结构 时 ， 它 可 能 不 再 应 用 视图 设置 。 

因此 ， 必 须 确保 系统 能 够 唯一 地 分 配 ， 以 便 应 用 程序 和 数据 结构 同时 加 载 。 用 一 个 唯一 
WH (KEY) 标记 数据 结构 。 用 户 保 存 了 所 有 视图 ， 给 出 了 这 样 的 识别 但 。 

程序 员 可 以 使 用 ALV 组 件 接口 控制 器 的 方法 GET. CONFIG. DATA 得 到 一 个 视图 所 有 的 
DES 


6.4.5 ^il 


用 户 可 以 在 两 个 不 同 的 文件 格式 下 导出 正在 显示 的 ALV 输出 : 

e 使 用 Microsoft Excel 

e 使 用 Adobe Acrobat 

此 外 ,用户 还 可 以 把 ALV 输出 输出 到 BEx 分 析 仪 。 但 是 对 结果 不 能 做 任何 进一步 的 规范 。 
6.4.5.1 Microsoft Excel 

M ALV 输出 生成 Excel K, HP R mA L RS pe qH ZBH , 

在 应 用 程序 中 ， 可 以 定义 是 个 将 ALV 输出 以 外 的 信息 复制 到 Excel 文件 中 ， 如 : 

e 页 由 和 页 脚 区 域 的 设计 对 象 。 

e ART HÁT. 


注 : 目前 ，Excel 格 式 支持 版 本 MHTML 和 2000/97 的 MHTML。 要 设置 想 要 的 格式 ， 执 行 
报表 SALV BS ADMIN MAINTAIN. 


(1) 复制 设计 对 象 到 Excel 文件 

如 果 已 经 定义 了 一 个 ALV 输出 的 页 眉 或 页 脚 的 设计 对 象 ， 则 可 以 指定 设计 对 象 的 内 容 是 否 
复制 到 Excel 文件 中 。 把 设计 对 象 复 制 到 Excel 文件 可 以 使 用 接口 类 IF SALV WD 
EXPORT SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-72. 
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X 6-72 


功 能 Aa 3 
复制 设计 对 象 为 Excel WJA SET EXPORT NO TOL 
Fr trat EDS RE] Excel WE GET EXPORT NO TOL 
复制 设计 对 象 为 Excel 页 脚 SET EXPORT NO EOL 
检 碍 是 否 复制 设计 对 象 到 Excel 页 脚 GET EXPORT NO EOL 


(2) 复制 用 于 计算 的 结果 行 到 Excel 文件 

可 以 定义 合计 结果 行 或 中 间 小 计 结 果 行 是 否 应 该 复制 到 Microsoft Excel 中 。 可 以 使 用 接 
口 类 IF SALV WD EXPORT SETTINGS ( 实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 
见 表 6-73. 


表 6-73 
J 能 Za. Ah 
将 结果 行 复制 到 Excel 中 SET EXPORT NO SUMS 
检查 结果 行 是 否 会 被 复制 到 Excel 中 GET EXPORT NO SUMS 


6.4.5.2 Adobe Acrobat 

用 尸 可 以 打印 当前 显示 的 ALV 输出 。 要 做 到 这 一 点 , 用户 可 以 选择 工具 栏 上 的 按钮 (Print 
Version), ALV 根据 ALV 输出 的 数据 生成 一 个 标准 的 PDF 文件 ， 启 动 Adobe Acrobat (系统 
已 安 关 该 软件 )， 并 显示 生成 的 PDF 文件 。 

用 户 可 以 使 用 “设置 ”对 话 框 设置 相关 显示 的 PDF 文件 。 在 应 用 程序 中 也 有 相同 的 选项 。 
可 定义 预 设 的 PDF 文档 : 

e 定义 纸张 格式 和 对 章 。 

e 定义 可 打印 区 域 的 大 小 。 

e "7I. 

e 自 接 将 输出 发 送 到 打印 机 。 

e 设置 页 慎 和 页 脚 。 

e 复制 设计 对 象 到 PDF 文件 。 

也 可 以 定义 页 眉 或 页 脚 的 设计 对 象 是 否 也 应 该 显示 在 PDF 文件 中 。 

(1) 定义 纸张 格式 和 对 齐 

可 以 指定 PDF 文档 的 文件 格式 。 选 择 文 件 格 式 如 下 : 

€ DIN A4. 

@ Letter。 

xe up DE X e rk zs PDF 文档 为 纵 回 或 横 回 格式 ， 可 以 使 用 接口 类 IF SALV. WD 
PDF SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-74. 


表 6-74 
功 能 Ao dA 
定义 的 纸张 格式 SET PAGE SIZE 
纸张 格式 GET PAGE SIZE 
设置 纸张 方向 SET ORIENTATION 
ARKA In] GET ORIENTATION 
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(2) 定义 可 打印 区 域 的 大 小 


可 以 定义 PDF 文档 页 面 上 的 可 打印 区 域 的 大 小 、 指 定 页 边 距 的 宽度 。 也 可 以 指定 设置 测 
量 单位 ， 可 以 使 用 接口 类 IF SALV WD PDF SETTINGS (实现 类 CL SALV WD CONFIG 


TABLE) 的 方法 ， 见 表 6-75. 


功 


rani 
CC 


定义 测量 单位 边 距 
取得 测量 单位 边 距 


定义 页 脚 、 页 眉 、 右 边 距 和 左边 距 的 宽度 


取得 页 脚 、 页 眉 、 右 边 距 和 左边 距 的 宽度 


(3) 缩放 列 和 行 


表 6-75 


SET MARGINS UNIT 
GET MARGINS UNIT 


SET MARGIN BOTTOM 
SET MARGIN TOP 

SET MARGIN RIGHT 
SET MARGIN LEFT 


GET MARGIN BOTTOM 
GET MARGIN TOP 

GET MARGIN RIGHT 
GET MARGIN LEFT 


RAIL F, RE ALV 输出 的 PDF 文件 的 列 具 有 相同 的 宽度 。 如 果 在 一 个 页 面 上 没 
有 足够 的 空间 显示 所 有 列 ， 则 该 表 补 分 割 成 两 个 或 更 多 的 页 。 每 页 同样 容纳 必要 的 行 目 。 有 
个 同 的 选项 用 于 修改 PDF 文件 的 页 面 太 寸 与 列 和 行 的 大吉: 

e 减少 列 的 客 上 度 ， 使 它们 缠 小 到 一 个 页 面 。 


e mU. 


e j/bX SS MI ESET Ae SU v E. 


e (p vM EA. 


e 如 打 列 分 布 在 多 个 页 面 ， 则 可 以 定义 茶 坚 信息 是 人 否 应 该 上 只 出 现在 第 一 页 或 在 随后 的 页 


HEER. 


e 如 朱 列 的 宽度 是 不 变 的 ， 则 列 标题 显示 在 所 有 网 页 上 。 
e 如 和 朱 列 的 宽度 有 友 生 变化 ， 则 列 标题 在 随后 的 页 面 上 显示 。 


e Je: 固定 列 重 复 的 所 有 后 续 页 。 
缩放 列 和 行 ， 可 以 使 用 接口 类 IF SALV WD PDF SETTINGS (实现 类 CL SALV WD ` 


CONFIG TABLE) 的 方法 ， 见 表 6-76。 


表 6-76 
Yy 能 DM - 
定义 PDF WHP IS K ARX SET PAGE LAYOUT 
取得 PDF FHP HIR AEI GET PAGE LAYOUT 


如 果 页 面 宽度 调整 ， 则 重复 列 标题 

如 条 页 面 宽度 调整 ， 则 检查 是 人 否 重 复 列 标题 
相 邻 的 页 面 ， 重 复 列 标题 

相 邻 的 页 面 ， 请 检查 是 否 重 复 列 标题 

在 每 一 页 上 重复 固定 的 列 

检查 是 否 在 每 一 页 上 重复 固定 的 列 


(4) 直接 将 输出 发 达到 打印 机 


SET REPEAT HEADERS FIT H 
GET REPEAT HEADERS FIT H 

SET REPEAT HEADERS WALLPAPER 
GET REPEAT HEADERS WALLPAPER 
SET REPEAT KEY COLUMNS 

GET REPEAT KEY COLUMNS 


可 以 选择 要 创建 为 PostScript 文件 ， 而 不 是 一 个 PDF X fF. PostScript 文件 被 直接 发 送 到 
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选择 的 打印 机 。 
RS 如 果 没 有 在 这 里 指定 输出 装置 ， 则 生成 一 个 PDF 文件 ， 并 显示 在 屏幕 上 。 


设置 即时 打印 ， 可 以 使 用 接口 类 IF SALV WD PDF SETTINGS (实现 类 CL SALV 
WD CONFIG TABLE) 的 方法 ， 见 表 6-77. 


表 6-77 
E 能 Ao dE 
设置 ALV 立即 打印 输出 SET PRINT IMMEDIATE 
检查 是 否 ALV 立即 打印 输出 GET PRINT IMMEDIATE 
设置 打印 机 SET PRINTER 
获取 打印 机 GET PRINTER 


(5) 设置 页 由 和 页 脚 

可 以 使 用 文本 模块 ， 为 PDF 文档 创建 页 丑 或 页 脚 。 页 丑 或 页 脚 会 出 现在 每 一 页 中 。 这 样 
做 时 ， 必 须 指定 文本 模块 的 位 置 〈 中 间 对 齐 、 左 对 齐 或 右 对 齐 )。 

可 以 放置 在 所 需 位 置 的 文本 模块 有 : 

e ELF: 当前 位 置 没 有 被 占用 。 

e 目 定 义 文 本 : 当前 位 置 插入 目 定 义 文 本 。 

e 当前 日 期 : 当前 日 期 和 时 间 

e “INR. 

e iH lof? 

当前 页 数 和 总 页 数 。 

将 文本 模块 放置 于 页 眉 和 页 脚 中 ， 可 以 使 用 接口 类 IF SALV WD PDF SETTINGS (E 
MÆ CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-78. 


X 6-78 


J 8 2p. A 
SET FOOTER CENTER FREETEXT 
SET FOOTER LEFT FREETEXT 
NUN SET FOOTER RIGHT FREETEXT 
JU ag ` 一 | 人 Eun ^ e zb, CES 
Peg hd EAI e X CA SET HEADER CENTER FREETEXT 
SET HEADER LEFT FREETEXT 
SET HEADER RIGHT FREETEXT 
GET FOOTER CENTER FREETEXT 
GET FOOTER LEFT FREETEXT 
TT GET FOOTER RIGHT FREETEXT 
三 | N — DX Bun q e EM — — 
取得 个 同位 置 的 目 定义 文本 GET HEADER CENTER FREETEXT 
GET HEADER LEFT FREETEXT 
GET HEADER RIGHT FREETEXT 
SET FOOTER CENTER 
SET FOOTER LEFT 
PIERE E S SET FOOTER RIGHT 
Pe C PADI HAE SET HEADER CENTER 
SET HEADER LEFT 
SET HEADER RIGHT 
GET FOOTER CENTER 
GET FOOTER LEFT 
n DET GET FOOTER RIGHT 
取得 文本 模块 的 不 同位 置 GET HEADER CENTER 
GET HEADER LEFT 
GET HEADER RIGHT 


CC 
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(6) 复制 设计 对 象 到 PDF 文件 

WARE ALV 输出 的 页 丑 或 页 脚 中 已 经 定义 了 一 个 设计 对 象 , 则 可 以 定义 该 设计 对 象 的 内 
容 是 否 也 应 该 被 复制 到 PDF 文件 ， 可 以 使 用 接口 类 了 正 SALV_WD PDF SETTINGS (实现 类 
CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-79. 


表 6-79 
Yy 能 » $ 
复制 设计 对 象 为 PDF 标题 SET EXPORT NO TOL 
检查 是 否 复制 设计 对 象 为 PDF 标题 GET EXPORT NO TOL 
复制 设计 对 象 为 PDF 页 脚 SET EXPORT NO EOL 
检查 是 否 复制 设计 对 象 为 PDF 页 脚 GET EXPORT NO EOL 


65 功能、 交互 和 事件 


ALV 输出 的 不 只 是 给 用 户 用 来 显示 表 结 构 数 据 。 用 户 还 可 以 用 各 种 方式 与 ALV 输出 列 
表 交 互 。 可 使 用 下 列 选 项 : 

1) 标准 ALV 功能 。 在 工具 栏 “ 设 置 ” 对 话 框 中 ， 可 以 显示 或 隐藏 各 种 UI 元素， 使 用 这 
些 元 素 ， 用 户 可 以 访问 ALV 输出 服务 。 

2) 自 定义 ， 应 用 程序 特定 的 功能 。 创 建 与 该 用 户 可 以 运行 的 功能 设置 或 标准 的 ALV IJ 
能 ， 从 而 有 效 地 使 用 应 用 程序 在 工具 栏 上 的 UI 元 素 。 

3) 互动 式 UI 元素 ALV 输出 表 。 在 ALV 输出 表 中 ， 可 以 使 用 交互 式 UI 元 素 〈 如 列 中 的 
单元 格 编辑 器 和 ALV 输出 的 单元 格 )。 有 以 两 种 类 型 的 交互: 

e 没有 数据 变化 的 交互 。 

e 有 数据 变化 的 交互 。 

UI 元素 有 用 户 操作 的 各 种 事件 处 理 。 


6.5.1 提供 ALV 功能 


标准 的 ALV 功能 包括 排序 、 和 莽 选 和 计算 。 

除了 标准 的 ALV 功能 外 ， 可 以 使 用 用 户 目 定义 的 、 特 定 于 应 用 程序 的 功能 来 显示 UI 
JUR e 

可 以 进行 以 下 功能 设置 : 

e 提供 标准 的 ALV 功能 。 

e 创建 、 获 取 和 删除 功能 。 

@ 指定 UI 元 素 。 

@ 在 工具 栏 指定 位 置 。 

e 控制 可 见 性 和 状态 激活 。 

@ 事件 处 理 功 能 。 

6.5.1.1 提供 标准 的 ALV 功能 

可 以 选择 不 同 的 程序 ， 为 用 户 提 供 一 个 标准 的 ALV 功能 : 
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1) 显示 标准 ALV 功能 : UI 元 素 的 类 型 和 使 用 的 标签 默认 设置 。 根 据 标准 ALV 功能 ， 
UI 元 素 显 示 在 “设置 ”对 话 框 或 在 工具 栏 上 。 可 以 指定 标准 ALV 功能 是 向 用 户 提供 相关 的 
标准 功能 的 UI 元 素 。 

2) 提供 工具 栏 的 奉 代 功能 。 如 果 想 实现 在 工具 栏 上 的 UI 元 素 与 标准 设置 有 所 不 同 ， 则 
可 添加 不 同类 型 的 UI 元 素 到 工具 栏 并 允许 使 用 标准 ALV 功能 ， 但 隐藏 相应 的 UI 元素 ,然后 
生成 一 个 用 户 定义 的 函数 ， 并 将 方法 分 配 到 所 需 的 标准 ALV 功能 。 

(1) 显示 标准 ALV 功能 

如 果 使 用 ALV 配置 模型 ， 则 所 有 标准 的 ALV 功能 对 象 会 自动 创建 。 程 序 员 只 需要 指定 
是 否 允 许 用 户 使 用 此 相关 功能 即 可 。 


注 : 默认 情况 下 , 所 有 的 标准 ALV 功能 都 显示 , 但 这 里 需要 计算 的 标准 功能 是 个 例外 (和 包 
括 中 间 结 果 )。 


可 以 在 接口 类 IF SALV WD STD FUNCTIONS (实现 类 CL SALV WD CONFIG ` 
TABLE) 找到 所 需 的 方法 。 所 有 这 些 方法 都 包含 参数 类 型 ABAP_BOOL H, ILK 6-80. 


表 6-80 
显示 和 隐藏 列 
列 选 择 标签 页 | SET COLUMN SELECTION ALLOWED 


“排序 ”选项 卡 页 面 SET SORT COMPLEX ALLOWED 


通过 单 击 列 标题 排序 列 标题 中 的 箭头 图 标 SET SORT HEADERCLICK. ALLOWED 
过 滤器 标签 页 SET FILTER COMPLEX ALLOWED 


工具 栏 上 的 过 滤器 按钮 SET FILTER FILTERLINE ALLOWED 


Calculations 


所 有 元 素 的 中 间 结 果 [ | SET GROUP AGGREGATION ALLOWED 


计数 表 中 条 目 SET COUNT RECORDS ALLOWED 


Display 


SET DISPLAY SETTINGS ALLOWED 
层次 复 选 枉 和 定义 按钮 SET HIERARCHY ALLOWED 


视图 下 拉 列 表 框 REN SET VIEW LIST ALLOWED 


Editable ALV 


“MUAT” Fel 
“追加 行 ” 按 铀 
“删除 行 ” 按 包 
“检查 ” 按 包 
“am” He 


SET EDIT INSERT ROW ALLOWED 


SET EDIT APPEND ROW ALLOWED 


ite-protecti 性 设置 
WA write-protection 属性 设置 无 SET EDIT DELETE ROW ALLOWED 


PS 全 已 LE 
效 只 能 显示 


SET EDIT CHECK AVAILABLE 


SET EDIT UNDO ALLOWED 
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m 


rani 
CC 


Export 
F TE D 
= ZN EU Y ng 
"m Ec BEx AFBTOUN P 如 果 配 置 相 应 的 系统 只 能 显示 SET BEX ANALYZER ALLOWED 
打印 版 本 按钮 和 标签 页 [E 1 SET PDF ALLOWED 
Display As 
显示 方式 为 下 拉 列 表 框 SET DISPLAY AS ALLOWED 
图 形 显示 为 下 拉 列 表 框 如 条 标准 功能 中 的 图 形 或 Excel 
中 的 条 目 | I 人 至少 有 一 个 被 打开 , 则 下 拉 列 表 框 SET GRAPHIC ALLOWED 


Excel 中 显示 为 下 拉 列 | 才 是 可 见 的 


SET_EXCEL INPLACE ALLOWED 
表 框 中 的 条 目 - - 


Send 


发 送 按钮 | | SET BI BROADCASTING ALLOWED 


注 : 相关 取得 方法 的 名 称 以 IS «method NAME> 开 始 ， 而 不 是 以 SET. «method NAME> 


开始 。 


(20 在 工具 栏 提 供奉 代 功 能 


如 条 用 户 想 在 工具 栏 上 使 用 标准 设置 以 外 的 不 同 奖 型 或 标签 UI 元 系 ， 则 允许 使 用 标准 
ALV 功能 ， 但 要 隐藏 相应 的 UI 元 了 又， 然后 生成 一 个 用 户 定 义 的 函数 ， 并 为 其 指定 所 需 的 标 


准 ALV 功能 。 
程序 员 可 以 用 标准 ALV 功能 替换 如 下 UI 元 素 : 


Send 下 拉 列 表 框 与 下 拉 列 表 框 中 的 个 别 项 目 。 

Display As 下 拉 列 表 框 与 下 拉 列 表 框 中 的 个 别 项 目 。 

Insert Row (jfi NT). Append Row GBJHIIT) #H Delete Row OllERSTTO TZ. 

Check RA) 按钮 。 

Undo GEO 按钮 。 

Excel 和 Print Version 《打印 版 本 ) 按钮 。 

Filter (过 滤器， 按钮 、Define Filter (定义 过 滤 ) 和 Delete Filter MIRI) 功能 。 
Settings (设置 ) 按钮 、Open Settings Dialog Box (H FW AXIE) 和 Close Settings 
Dialog Box 关闭 设置 对 话 框 ) 功能 。 

Views 视图) 下 拉 列 表 框 。 


要 指定 一 个 标准 的 ALV 功能 到 一 个 目 定 义 的 函数 ， 则 可 以 使 用 类 CL SALV WD ` 
FUNCTION 的 方法 ， 见 表 6-81. 


表 6-81 
JJ 能 I Q 
标准 ALV 功能 分 配 到 自 定 义 的 函数 SET FUNCTION STD 
标准 ALV 功能 ， 被 分 配 到 一 个 自 定 义 的 函数 GET FUNCTION STD 


(3) 系统 设置 导出 到 在 BEx 分 析 仪 
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如 果 用 户 想 通过 应 用 程序 将 ALV 输出 导出 在 BEx 分 析 仪 中 ， 必 须 满 足以 下 先决 条 件 : 
e 确保 BI 系统 的 安装 。 这 意味 着 ，BEx 分 析 仪 也 是 可 用 的 。 
€ 在 SAP NetWeaver 的 定制 中 ， 单 击 “Application Server” 一 “Web Dynpro for ABAP” 
—> “System-Wide Settings for the Web Dynpro ALV” MS, 取消 选择 Hide BEx Analyzer 
Export Function. 
6.5.1.2 创建、 获取 和 删除 功能 
如 果 使 用 ALV 配置 模型 ， 则 所 有 标准 的 ALV 功能 对 象 会 自动 创建 。 对 象 是 类 CL 
SALV WD FUNCTION STD 的 引用 。 
使 用 用 户 自 定义 的 功能 , 在 其 功能 函数 中 可 以 创建 类 CL SALV WD. FUNCTION 的 一 个 
国 数 对 象 。 根 据 需要 ， 可 以 创建 许多 函数 对 象 ， 并 安排 它们 在 工具 栏 上 。 
程序 员 可 以 进行 以 下 设置 : 
e 创建 一 个 用 户 定义 功能 函数 的 对 象 。 
e 取得 功能 函数 的 对 象 。 
e 设置 和 获取 功能 函数 的 信息 。 
e 删除 一 个 用 户 定义 功能 的 对 象 。 
(1) 创建 一 个 用 户 自 定义 功能 的 对 象 
当 创 建 一 个 用 户 定 义 函 数 时 ， 程 序 员 可 以 指定 一 个 唯一 的 ID 〈 类 型 STRING). 
要 生成 一 个 函数 对 象 ， 使 用 接口 类 IF SALV WD FUNCTION SETTINGS (实现 类 
CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-82. 


表 6-82 


Ij 


创建 用 户 定 义 的 函数 功能 CREATE FUNCTION 


法 


amp 
CC 
ut 


(2) 取得 功能 函数 的 对 象 

为 了 设置 一 个 函数 对 象 ， 必 须 首 先 调 用 一 个 适当 的 GET 方法 。 程 序 员 可 以 选择 从 工具 栏 
上 得 到 以 下 功能 : 

e 所 有 的 标准 ALV 功能 或 特定 的 功能 。 

e 所 有 用 户 自 定义 的 函数 功能 或 特定 的 功能 。 

e 只 有 工具 栏 上 和 面 的 标准 的 ALV 功能 。 

e 所 有 工具 栏 上 面 的 用 户 自 定义 的 函数 或 特定 的 功能 。 

获取 函数 对 象 ， 可 使 用 接口 类 IF SALV WD FUNCTION SETTINGS (实现 类 CL | 
SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-83. 


表 6-83 
Yy 能 J dE 
获取 所 有 标准 的 ALV 功能 GET FUNCTIONS STD 
具体 标准 ALV 功能 GET FUNCTION STD 
获取 所 有 用 户 定 义 的 功能 GET FUNCTIONS 
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CHE) 


Jj 能 À à 
获取 特定 的 用 户 定 义 的 功能 GET FUNCTION 
从 左边 的 工具 栏 获取 ALV 所 有 标准 功能 GET FUNCTIONS LEFT STD 
从 左 侧 的 工具 栏 获取 所 有 用 户 定义 的 功能 GET FUNCTIONS LEFT 
从 左手 侧 的 工具 栏 获取 特定 的 用 户 定义 的 功能 GET FUNCTION LEFT 
获取 所 有 标准 ALV 的 右 侧 工具 栏 的 功能 GET FUNCTIONS RIGHT STD 
获取 所 有 用 户 定义 的 函数 右手 边 的 工具 栏 GET FUNCTIONS RIGHT 
取得 具体 的 右 侧 工具 栏 的 用 户 定义 的 功能 GET FUNCTION RIGHT 


(3) 设置 和 获取 功能 函数 的 信息 

可 以 检 碍 工具 栏 的 功能 ， 以 确定 它 是 否 是 一 个 标准 的 ALV 功能 或 用 户 定义 的 功能 。 

用 户 还 可 以 指定 以 下 属性 : 

1) ID。 标 准 ALV 功能 的 ID 被 目 动 创建 。 它 包含 了 有 关 标 准 的 ALV 功能 的 信息 。 一 个 
用 户 定 义 功能 函数 的 ID 是 程序 员 在 对 象 创建 时 指定 的 ID. 

2) Group。 可 以 根据 任何 标准 ， 使 用 组 名 划分 功能 。 

对 于 设置 和 获取 的 信息 ， 可 以 使 用 类 CL SALV WD FUNCTION 或 类 CL SALV WD ` 
FUNCTION STD 中 的 方法 ， 见 表 6-84. 


表 6-84 
X 能 B 3 
功能 型 GET TYPE 
功能 ID GET ID 
分 配 功能 的 一 组 SET GROUP 
功能 被 分 配 到 组 的 名 称 GET GROUP 


(4) 删除 一 个 用 户 定义 功能 的 对 象 

程序 员 只 能 删除 用 户 定 义 的 功能 函数 的 对 象 ， 不 能 删除 标准 ALV 功能 的 对 象 。 

要 删除 一 个 用 户 目 定义 的 功能 ， 需 指定 功能 了 。 要 做 到 这 一 点 ， 可 以 使 用 接口 类 
IF SALV WD FUNCTION SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 
见 表 6-85. 


表 6-85 
X) 5 方 ” 法 
删除 用 户 定义 的 功能 DELETE FUNCTION 
6.5.1.3 ”预定 义 Context 市 点 
些 目 定 义 功 能 可 以 插入 到 工具 栏 中 ， 当 用 户 触发 时 会 导致 数据 改变 。 因 此 ， 这 些 功 能 

需要 链接 到 应 用 程序 Context 节点 。 要 做 到 这 一 点 ， 必 须 定义 一 个 外 部 环境 映射 到 ALV 接口 
控制 器 Context 节点 的 FUNCTION ELEMENTS 上。 为 每 个 功能 对 应 的 Context 节点 生成 一 个 
合适 的 属性 或 子 节 点 。 

6.5.1.4 指定 UI 元 素 

可 以 为 目 定义 功能 使 用 下 面 UI 7625: 
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Button (CL SALV WD FE BUTTON). 

ButtonChoice (CL SALV WD FE BUTTON CHOICE), 
DropDownByIndex (CL SALV WD FE DROPDOWN BY IDX). 
DropDownByKey (CL SALV WD FE DROPDOWN BY KEY). 
InputField (CL SALV WD FE INPUT FIELD). 

LinkToAction (CL SALV WD FE LINK TO ACTION). 
LinkToURL (CL SALV WD FE LINK TO URL). 

ToggleButton (CL SALV WD FE TOGGLE BUTTON). 

对 于 个 体 UI 元 系 之 间 的 分 阳线 : 

€ Separator (CL SALV WD FE SEPARATOR). 


注 : 程序 员 可 以 在 系统 中 的 包 SALV WD CONFIG 中 找到 相关 类 。 


指定 UI 元 素 的 自 定 义 功 能 的 步骤 如 下 : 

@ 生成 一 个 功能 对 象 。 

e 生成 工具 栏 上 面 列 出 的 元 素 之 一 。 

e 根据 需要 指定 工具 栏 元 素 的 属性 。 

e 分 配 工 具 栏 元 素 到 功能 函数 。 

要 指定 一 个 合适 的 UI 元 素 到 一 个 函数 对 象 ， 可 以 使 用 类 CL. SALV WD. FUNCTION 中 
的 方法 ， 见 表 6-86. 


xx 6-86 
功 Bé mo uA 
设置 UI 元 素 SET EDITOR 
取得 UI 元素 GET EDITOR 


6.5.1.5 ”在 工具 栏 中 指定 位 置 

可 以 以 不 同 的 方式 指定 功能 的 位 置 : 

1) 指定 工具 栏 中 UI 元 素 对 齐 。 可 以 指定 功能 元 素 在 工具 栏 中 的 对 齐 方式 是 左 对 齐 还 是 
右 对 齐 。 

2) 指定 位 置 。 可 以 指定 在 哪个 位 置 显 示 功 能 。 

要 指定 一 个 标准 的 ALV 功能 的 位 置 , 可 以 使 用 类 CL SALV WD FUNCTION STD 中 的 
233255 

要 指定 一 个 自 定义 功能 的 位 置 ， 可 以 使 用 类 CL SALV WD FUNCTION 中 的 方法 ， 见 
表 6-87。 


表 6-87 
E 能 Wo NE 
指定 工具 栏 中 的 对 齐 方式 SET ALIGNMENT 
取得 工具 栏 中 的 对 齐 方式 GET ALIGNMENT 
设置 位 置 编号 SET POSITION 
取得 位 置 编号 GET POSITION 
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6.5.1.6 ”控制 可 见 性 和 激活 状态 

可 以 指定 是 否 以 不 同 的 方式 使 用 目 定义 函数 : 

e 可 以 关闭 一 个 单独 的 UI 元素 的 功能 。 

e 可 以 隐藏 一 个 单独 的 UI 元 素 的 功能 。 

e 可 以 关闭 整个 工具 栏 。 

e 可 以 隐藏 整个 工具 栏 。 

(1) 激活 和 取消 激活 功能 

如 采用 户 不 硕 望 隐藏 UI 元素 ， 要 防止 用 户 执 行 它 的 功能 ， 则 可 以 禁用 UI 元素 。 

要 激活 或 禁用 标准 ALV 功能 的 UI 元素 ， 需 使 用 类 CL SALV WD FUNCTION STD 中 
的 方法 。 

要 激活 或 禁用 的 UI 元素 的 日 定义 功能 ， 可 以 使 用 UI 元素 类 的 方法 ， 见 表 6-88. 


表 6-88 
JJ 能 2 
局 用 /禁用 功能 对 象 SET ENABLED 
取得 功能 对 象 的 状态 GET ENABLED 


(2) 显示 和 隐藏 功能 

以 下 两 个 营 量 ， 可 用 于 显示 和 隐藏 功 能 。 

1) VISIBILITY-VISIBLE: 该 系统 显示 的 功能 。 

2) VISIBILITY-NONE: 该 系统 隐藏 的 功能 。 

要 显示 或 隐藏 标准 ALV 功能 的 UI 元 素 ， 可 以 使 用 类 CL SALV WD FUNCTION STD 
Pm E. 

要 显示 或 隐藏 UI 元素 的 自 定义 功能 , 可 以 使 用 类 CL SALV. WD FUNCTION 中 的 方法 ， 
见 表 6-89。 


表 6-89 
Xi 能 J dX 
显示 /隐藏 功能 对 象 SET VISIBILITY 
获得 显示 状态 GET VISIBILITY 


G) 显示 、 隐 着 和 禁用 的 工具 栏 
为 了 控制 整个 工具 栏 的 激活 状态 或 可 见 性 ， 使 用 的 接口 类 IF_SALV_WD FUNCTION 
SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-90. 


表 6-90 
E 能 MES 
激活 /关闭 工具 栏 SET ENABLED 
获得 活动 状态 GET ENABLED 
显示 /隐藏 工具 栏 SET VISIBILITY 
获得 显示 状态 GET VISIBILITY 
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6.5.1.7 ”事件 处 理 函 效 

CD 标准 ALV 功能 事件 

使 用 标准 ALV 功能 ， 只 能 在 两 个 特定 的 时 间 点 处 理 : 当 用 户 执行 一 个 功能 处 理 或 当 用 户 
完成 一 个 功能 处 理 。 用 户 选 择 没有 收 a 到 任何 有 关 的 标准 ALV 功能 。 

可 以 使 用 下 面 的 事件 来 处 理 标准 的 ALV 功能 : 

@ ON STD FUNCTION BEFO。 

€ ON STD FUNCTION AFTE. 

(2) 自 定 义 的 功能 事件 

使 用 日 定义 功能 ， 可 以 决定 哪些 功能 是 用 户 选 择 的 。 

事件 ON _ FUNCTION 是 可 用 来 处 理 目 定义 的 功能 。 


6.5.20 ”没有 数据 变化 的 交互 与 处 理 


并 非 在 所 有 ALV 输出 中 用 户 的 操作 会 引起 数据 的 变化 。 例 如 下 面 的 操作 ， 不 会 导致 数据 
的 变化 : 

e 改变 行 的 选择 (选择 行 )。 

e 选择 超 链 接 、 按 钮 及 开关 按钮 。 

程序 员 可 以 进行 各 种 设置 ， 以 控制 或 处 理 这 种 交互 。 

6.5.2.1 ”选择 行 和 列 

可 以 决定 用 户 是 否 可 以 一 次 性 选择 多 个 行 或 列 。 

e 能 够 选择 列 。 使 用 选择 的 状态 ， 程 序 员 可 以 指定 用 户 在 同一 时 间 是 否 可 以 选择 多 列 。 

e 能 够 选择 行 。 使 用 选择 类 型 ， 程 序 员 可 以 指定 用 户 在 同一 时 间 是 人 否 可 以 选择 多 行 以 及 
是 否 存在 头 选 择 (Lead Selection), 


注 : 用 户 还 可 以 在 写 保护 的 ALV 输出 中 选择 行 。 如 果 关闭 ALV 输出 的 写 保护 ， 则 无 论 
选择 类 型 用 户 都 不 可 以 选择 任何 行 . 


也 可 以 屏蔽 用 户 选 择 特 定 的 单元 格 或 所 有 单元 格 。 

(1) 设置 选择 状态 

程序 员 可 以 分 别 为 每 列 指定 选择 状态 。 可 以 使 用 下 面 的 选择 状态 : 

e 未 选择 : 任何 现 有 的 选择 将 被 删除 。 

@ 选择 : 该 列 被 选中 。 

e 不 可 选 : 用 户 不 可 以 选择 该 列 。 

要 解决 列 选择 ， 可 以 使 用 类 CL SALV WD COLUMN 的 方法 ， 见 表 6-91. 


表 6-91 
E 能 I: AA 
指定 选择 状态 SET SELECTION STATE 
取得 选择 状态 GET SELECTION STATE 
(2) 设置 选择 类 型 
可 以 使 用 下 面 的 选择 类 型 
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e Hz: Context 节点 设置 。 

e 无 选择 (NONE): 在 行 的 最 右 端 没 有 任何 用 于 选择 行 的 按钮 显示 。 

e XE (SINGLE): 在 行 的 最 右 并 显示 用 于 选择 行 的 按钮 。 用 户 只 能 选择 单列 。 该 行 
锌 显示 为 头 选 择 。 如 果 用 户 选 择 了 为 一 行 ， 则 头 选 择 也 被 改变 。 

e CLF (SINGLE NO LEAD): 在 行 的 最 右 端 显示 用 于 选择 行 的 按钮 。 用 户 
只 能 选择 一 个 单列 。 如 果 用 户 选 择 了 为 一 行 ， 则 选择 将 被 改变 。ALYV 输出 不 含 头 选择 。 

e 多 行 (MULTD: 在 行 的 最 右 问 显示 用 于 选择 行 的 按钮 。 用 户 可 以 通过 按 住 《Ctrl〉 键 
的 同时 选择 多 行 。 选 择 的 第 一 行为 头 选择 。 

e 不 含 头 选择 的 多 行 (MULTI NO LEAD): 在 行 的 最 右 端 显示 用 于 选择 行 的 按钮 。 用 
户 可 以 通过 按 住 〈Ctrl〉 键 的 同时 选择 多 行 。ALYV 输出 不 含 头 选择 。 


注 : 程序 的 Context 节点 来 指定 有 多 少 个 数据 记录 ， 可 以 选择 使 用 Selection 属性 

如 果 Selection 属性 值 1: 1， 则 必须 选择 一 个 条 目 。 如 果 该 值 是 0: n， 它 是 可 以 不 选择 任 
何 条 目 ， 或 根据 需要 选择 多 条 。. 

使 用 选择 类 型 时 ， 用户 不 能 选择 Context 节点 中 定义 的 数字 。 如 果 党 试 做 到 这 一 点 ,运行 
时 发 生 错 误 ， 则 应 用 程序 终止 。 

例如 : 如 果 指 定 了 1: 1， 就 不 能 使 用 选择 类 型 MULTI 和 MULTI NO LEAD 的 。 


要 定义 选择 类 型 ， 使 用 接口 类 IF SALV WD TABLE SETTINGS (实现 类 CL SALV 
WD CONFIG TABLE) 的 方法 ， 见 表 6-92. 


表 6-92 
JJ 能 方 ” 法 
指定 选择 类 型 SET SELECTION MODE 
取得 选择 类 型 GET SELECTION MODE 


(3) 事件 处 理 
默认 情况 下 ， 在 列表 区 域 中 有 两 种 不 同 的 动作 啊 应 用 户 选 择 的 事件 : 
€ ON LEAD SELECTION: 该 动作 改变 用 户 的 头 选 择 。 如 果 用 户 改 变 选 择 ， 则 没有 种 
件 被 触发 。 
€ ON SELECT: 该 动作 用 于 改变 选择 或 头 选 择 。 
使 用 方法 IF SALV WD TABLE SETTINGS-SET ON SELECT ENABLED， 系 统 切 换 
到 事件 ON SELECT. 


注 : 如 果 将 系统 切换 到 ON_SELECT， 即 停 用 ON LEAD SELECTION 事件 的 事件 处 理 
T. 


(4) ERORE 
可 以 屏蔽 用 户 选 择 ALV 输出 行 。 


注 : 与 NONE 选择 类 型 相反 ， 按 钮 不 隐藏 ， 它 们 只 停 用 。 这 能 够 阻止 用 户 选择 行 。 
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程序 员 可 以 决定 是 否 要 屏蔽 所 有 ALV 输出 行 ， 或 者 只 是 屏蔽 特定 行 的 选择 。 
要 做 到 这 一 点 ， 使 用 接口 类 下 SALV WD TABLE SETTINGS (实现 类 CL SALV WD ` 
CONFIG_TABLE) 的 方法 ， 见 表 6-93. 


xx 6-93 
JJ 能 J. 这 
禁止 选择 所 有 ALV 输出 行 SET ROW SELECTABLE 
检查 是 否 不 允许 选择 所 有 行 GET ROW SELECTABLE 
禁止 选择 ALV 输出 中 的 特定 行 SET ROW SELECTABLE FIELDNAME 
获取 字段 名 ， 可 以 控制 是 否 可 以 选择 单独 的 行 GET ROW SELECTABLE FIELDNAME 


6.5.2.2 ”使 用 超 链 接 、 按 钮 和 切换 按钮 

在 ALV 输出 的 单元 格 中 可 以 使 用 UIR, 允许 用 户 来 触 友 某 些 动 作 。 下 和 面 的 UI 元 素 并 
不 会 目 动 导致 数据 的 变化 : 

e 超 链 接 LINK TO ACTION (UI 元 素 LinkToAction). 

e 超 链接 LINK TO URL (UI 元 素 LinkToURL )。 

e 按钮 (UI G= Button). 

e 切换 按钮 (UI ú= Toggle Button). 


注 : 以 上 所 列 的 交叉 引用 ， 引 用 一 般 可 用 的 Web Dynpro 对 象 。 指 定 的 类 名 ， 有 是 使 用 
表 6-94 中 列 出 的 ALV 配置 模型 的 类 名 。 


表 6-94 
UI ú 类 
超 链接 LINK TO_ACTION CL SALV WD UIE LINK TO ACTION 
超 链接 LINK TO URL CL SALV WD UIE LINK TO URL 
TI CL SALV WD UIE BUTTON 
开关 按钮 CL SALV WD UIE TOGGLE BUTTON 


可 以 使 用 事件 ON. CLICK 来 处 理 以 下 UI 元素 的 用 户 动 作 : 
e 超 链 接 LINK TO ACTION. 

e i. 

e Uu. 


6.5.3 ”可 编辑 ALV 的 互动 处 理 


可 以 使 用 ALV 输出 的 列 显示 UI 元素 ， 用 户 可 以 用 它 来 改变 显示 的 数据 。 

用 户 还 可 以 在 特定 的 位 置 插入 行 ， 把 它们 添加 到 ALV 输出 的 底部 ， 并 将 其 删除 。 

这 些 操 作 之 前 ，ALYV 输出 必须 停 用 写 保护 。 

还 必须 定义 时 间 ， 在 该 时 间 系 统 会 检查 更 改过 的 数据 是 否 是 正确 的 。 

6.5.3.1 ”与 保护 及 激活 

可 以 在 ALV 输出 中 显示 UI 元 素 , 可 以 改变 ALV 输出 中 的 数据 。 不过, 也 有 不 同 的 方法 ， 
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可 以 屏蔽 用 户 在 这 些 UI 元素 上 改变 数据 。 可 以 进行 以 下 设置: 

e 控制 ALV 输出 的 写 你 护 。 

e 激活 和 取消 激活 ALV 输出 。 

e 禁用 单独 的 UI 元素 。 

(1) 控制 ALV 输出 的 写 保护 

默认 情况 下 ，ALYV 得 出 是 写 保 护 的 ， 要 允许 用 户 更 改 数据 ， 则 必须 先 删除 该 写 保护 。 与 
保护 有 以 下 影响 : 

e UI 元 泰 ( 在 单元 格 中 ， 而 不 是 在 工具 栏 中 )， 人 允许 要 改变 的 数据 不 能 被 使 用 。 

e 如 果 ALV 输出 被 写 保 护 ， 在 工具 栏 上 的 标准 ALV 功能 〈 如 插 和 入、 添加、 删除 行 和 检 

查 数据 ) 被 隐藏 。 


注 : 如 果 用 户 删 除 ALV 输出 的 写 保护 ， 则 系统 为 ALV 输出 使 用 指定 的 顾 色 。 用 户 不 能 
再 影响 用 于 ALV 输出 的 颜色 。 


要 打开 或 关闭 写 保护 ， 可 以 使 用 接口 类 IF SALV WD TABLE SETTINGS (实现 类 
CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-95. 


表 6-95 
E 能 m. e 
打开 /关闭 写 保 护 SET READ ONLY 
检查 是 否 写 保护 开关 ON / OFF GET READ ONLY 


(2) 激活 和 取消 激活 ALV 输出 

默认 情况 下 ，ALYV 输出 被 激活 。 在 ALV 输出 的 所 有 交互 的 Ul 元素 ， 在 工具 栏 和 表 中 的 
部 分 均 可 操作 。 

要 启动 或 关闭 ALV 输出 ， 使 用 接口 类 IF SALV WD TABLE SETTINGS (实现 类 
CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-96. 


xx 6-96 
功 能 A - 
局 动 或 停 用 ALV 输出 SET ENABLED 
检查 ALV 输出 是 否 被 激活 GET ENABLED 


6.5.3.2 ”添加 和 删除 行 
可 以 在 工具 栏 上 为 用 户 提供 按钮 ， 在 ALV 输出 不 同 的 地 方 添加 或 删除 数据 记录 。 提 供 以 


下 功能 : 
e 搬入 行 。 如 下 用 户 没 有 选择 行 ， 则 创建 新 行 在 第 一 行 。 人 奋 则 ， 它 是 建立 在 选 定 的 一 行 
或 多 行 位 置 。 


e 追加 行 。 一 个 新 行 妃 加 到 ALV 输出 的 部 。 
e 删除 行 。 选 定 的 行 会 被 删除 。 
用 户 可 以 插入 或 删除 的 行 的 数目 取决 于 它 已 经 选择 了 多 少 行 。 可 以 使 用 选择 类 型 来 定义 
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Hi ur T i IPAT. 


E: 如 果 已 删除 写 保 护 的 ALV 输出 ， 则 过 些 按钮 是 唯一 可 见 的 。 
如 果 没 有 选择 No Selection Possible， 则 用 户 不 可 以 选择 任何 行 。 因 此 ， 用 于 插入 和 删除 
行 的 按钮 被 隐藏 。 


(1) 事件 处 理 

事件 ON DATA CHECK 包含 插入 或 删除 的 行 索 引 的 参数 。 

(2) X WEDA AIT 

用 户 可 以 切换 SAP 列表 查看 器 (ALV) 到 海量 数据 的 模式 。 从 而 自动 创建 一 个 空 的 页 ， 
MAMATE ALV 输出 结束 的 地 方 。 用 户 不 必 单 独 插入 每 一 个 新 的 行 ， 但 可 以 在 ALV 输出 
结束 的 地 方 填充 任意 数目 的 行 。 

ALV 输出 切换 海量 数据 的 模式 ， 使 用 接口 类 下 SALV WD TABLE SETTINGS (El 2 
CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-97. 


表 6-97 
JJ 能 J GE 
对 大 容量 数据 的 开 / 关 切换 模式 SET EDIT MODE 
检查 是 否 对 大 容量 数据 的 模式 切换 GET EDIT MODE 


6.5.3.3 ”更 改 单 元 格 的 内 容 

用 户 可 以 使 用 下 面 的 Ul 元素， 和 直接 改变 在 ALV 输出 数据 : 
e A^ CnputField). 

e Gi (CheckBox). 

e 切换 按钮 (Toggle button). 

e 二 态 复 选 杠 (TriStateCheckBox )。 

e 下 拉 列 表 框 (DropDownByKey )。 


注 : 上面 列 出 的 交叉 引用 是 指 常见 的 Web Dynpro 对 象 ， 不 是 指定 的 类 名 ， 而 是 ALV Bë 
置 模型 。 


可 以 使 用 下 和 面 的 类 名 ， 见 表 6-98. 


表 6-98 
UI 7628 2 
输入 框 CL SALV WD UIE INPUT FIELD 
复 选 框 CL SALV WD UIE CHECKBOX 
切换 按钮 CL SALV WD UIE TOGGLE BUTTON 
三 态 复 选 框 CL SALV WD UIE CHECKBOX TRI 
下 拉 列 表 框 CL SALV WD UIE DROPDOWN BY KEY 


注 : 用 户 使 用 UI 元 素 之 前 ， 必 须 关 闭 ALV 输出 的 写 保护 ， 还 必须 确保 ALV 输出 被 
激活 。 
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6.5.3.4 ”指定 检查 时 间 
在 可 编辑 的 ALV 中 ， 用 户 可 以 更 改 数据 ， 添 加 或 删除 行 。 这 些 变化 最 初 上 只 存储 在 ALV 
组 件 的 Context 中 。 在 预定 义 的 时 间 内 ， 系 统 的 数据 从 ALV 组 件 Context 传输 到 应 用 程序 的 
Context 中 ， 并 检 碍 为 正确 的 数据 类 型 的 数据 。 这 确保 了 后 续 行 动 被 应 用 到 最 新 的 数据 。 
例如 ， 当 用 户 单 击 工具 栏 中 的 “设置 ”按钮 使 用 ALV 服务 时 ， 系 统 会 自动 检查 数据 。 
可 以 指定 其 他 时 间 用 于 ALV 输出 中 的 当前 数据 与 应 用 程序 同步 : 
e “HPI F (Enter) 键 或 触发 系统 的 动作 (DATA CHECK ON CELL EVENT). 
使 用 此 设置 时 ， 应 确保 在 最 小 的 数据 更 改 的 状况 下 ， 有 避免 由 于 频 索 的 检 栓 对 系统 性 能 有 
负面 影 啊 。 
e 用 户 选 择 检查 (DATA CHECK ON CHECK EVENT)。 默 认 情 况 下 ， 在 关闭 写 保护 
的 ALV 输出 中 显示 这 个 按钮 。 该 设置 是 有 用 的 ， 如 果 用 户 一 个 一 个 处 理 多 个 数据 记 
录 时 ， 不 会 由 于 频繁 地 检查 对 系统 性 能 有 人 负面 的 影响 。 
e 当 触 发 系统 中 的 检查 。 
(1) RHF JEER A IST TR] 
要 指定 用 户 动 作 触 友 数 据 检 查 的 时 间 , 使 用 接口 类 正 SALV. WD. TABLE SETTINGS( 实 
MÆ CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-99. 


表 6-99 
功 能 A 3 
设 定时 间 SET DATA CHECK 
取得 时 间 GET DATA_CHECK 


(2) 事件 处 理 
当 数 据 被 检查 时 会 触发 事件 ON DATA. CHECK. 
6.5.3.5 ”刷新 显示 
默认 情况 下 ,对 变化 的 数据 检查 后 ，ALYV 输出 会 进行 目 动 刷 新 。 在 列表 中 的 数据 被 更 新 ， 
并 且 对 话 框 的 设置 被 应 用 到 数据 中 。 
(1) 自动 刷新 
系统 目 动 更 新 显示 ， 在 下 列 情况 下 对 话 框 中 被 应 用 的 设置 ， 用 户 不 能 改变 这 些 机 制 : 
e 用 户 插 入 行 ， 把 它们 添加 到 列表 末尾 或 删除 它们 。 
e 应 用 程序 应 用 于 对 数据 的 更 改 。 
e 用 户 通过 单 击 “ 应 用 ”或 “确定 ”按钮 将 对 话 框 中 的 设置 应 用 到 的 数据 中 。 
e 用 户 排序 或 者 过 滤 ALV 输出 。 
(2) 手动 刷新 
在 用 户 更 改 现 有 的 数据 记录 的 情况 下 ， 可 以 影响 ALV 输出 刷新 是 要 么 只 影响 到 的 数据 ， 
要 么 当前 设置 的 服务 施加 到 更 改 后 的 数据 。 这 有 两 种 方法 中 的 每 一 个 都 有 两 个 可 能 的 设置 : 
€ SET REFRESH ON DATA CHANGE: 控制 刷新 ， 当 用 户 更 改 的 数据 证 实 了 这 一 点 ， 
按 (Enter) 键 。 
€ SET REFRESH ON DATA CHECK: 控制 刷新 ， 当 用 户 更 改 的 数据 ， 并 选择 检 碍 
按钮 。 
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下 面 的 值 是 可 能 的 : 

€ REFRESH AND APPLY SERVICES: 在 列表 中 的 数据 被 更 新 的 设置 对 话 框 中 的 设置 
被 应 用 到 数据 中 。 

€ REFRESH DATA ONLY: 在 列表 中 的 数据 被 更 新 。 


6.5.4 ”为 用 户 提供 带 助 


可 以 选择 不 同 的 方式 为 应 用 程序 的 用 户 提 供 帮 助 。 可 以 在 ALV 输出 中 使 用 以 下 类 型 的 
帮助 : 
e 辅助 功能 说 明 Caccessibility Description )。 如 果 用 户 已 激活 辅助 功能 ， 则 指定 的 文本 会 
添加 到 快速 信息 (Quick Info )。 这 个 描述 是 提供 更 多 的 信息 到 ALV 输出 或 列 。 当 用 户 
将 焦点 移动 到 ALV 输出 或 列 时 该 摘 述 被 浏览 器 读 取 。 
e | Hir. 
当 用 户 将 鼠标 指针 集 留 在 工具 栏 上 的 UI 元 素 或 单元 格 上 时 , 快速 信息 文本 被 显示 。 如 果 
浏览 器 文 持 ， 则 辅助 功能 说 明 会 作为 额外 的 文本 目 动 添加 到 快速 信息 。 
e 说 明 (Explanation)。 在 工具 栏 或 列表 中 的 各 种 UI 元 到 的 说 明 属 性 。 如 果 用 户 切 换 到 
帮助 模式 下 ， 则 当 用 户 将 光标 移 到 UI 元 素 时 ， 该 属性 的 文本 显示 在 一 个 盒子 里 。 文 
本 说 明 属 性 的 显示 独立 于 工具 提示 。 
@ Web Dynpro 输入 帮助 。 
可 以 在 ALV 输出 中 使 用 下 面 的 输入 帮助 : ABAP 字典 搜索 帮助 、OVS 输入 帮助 、 自 定义 
输入 帮助 。 
(1) 辅助 功能 说 明 
辅助 功能 说 明 属 性 用 于 以 下 几 个 方面 : 
1) 整个 ALV 输出 。 
辅助 功能 说 明显 示 ALV 输出 的 标题 的 工具 提示 。 要 显示 它 ， 可 以 使 用 接口 类 IF SALV 
WD TABLE SETTINGS (实现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-100. 


表 6-100 
Yy 能 Hx 
指定 辅助 功能 说 明 SET ACC DESCRIPTION 
取得 辅助 功能 说 明 GET ACC DESCRIPTION 


2) AJ. 
辅助 功能 说 明显 示 列 标题 的 工具 提示 。 要 显示 它 ， 可 以 使 用 类 CL SALV WD COLUMN 
的 方法 ， 见 表 6-101. 


表 6-101 
JJ 能 Xr. x 
指定 辅助 功能 说 明 SET ACCESSIBILITY DESCR 
取得 辅助 功能 说 明 GET ACCESSIBILITY DESCR 


(Dy pL BIS 
可 以 为 ALV 和 输出 以 下 元 素 指 定 工 具 提 示 ， 见 表 6-102. 
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表 6-102 


对 于 ALV 输出 的 标题 
对 于 用 户 定 义 的 函数 SET TOOLTIP 和 GET TOOLTIP 

€ ALV 输出 标题 。 

e b. 

e 用 户 自 定 义 功能 (通过 使 用 的 UI 元素 )。 

e 甲 元 格 编辑 器 (通过 使 用 的 UI 元 素 )。 

(3) 说 明 

可 以 指定 ALV 输出 中 下 列 内 容 的 说 明 : 

1) Aj. 

20 用 户 自 定义 功能 (通过 使 用 的 UI 元 素 )。 

e i. 

e 下 拉 列 表 框 ( 索 引 和 键 )。 

e 输入 字段 。 

3) 单元 格 编辑 器 (通过 使 用 的 UI 元素 )。 

e i. 

e 复 选 枉 和 三 态 复 选 框 。 

e 下 拉 列 表 框 《索引 和 键 值 )。 

e 输入 字段 。 

e 文件 上 传 。 

说 明 的 类 和 方法 见 表 6-103。 

表 6-103 
CL SALV WD FE DROPDOWN BY IDX 

对 于 用 户 定 义 的 函数 CL SALV WD FE DROPDOWN BY KEY 


CL SALV WD UIE DROPDOWN BY IDX 
CL SALV WD UIE DROPDOWN BY KEY 


CL SALV WD UIE FILE UPLOAD 
CL SALV WD UIE INPUT FIELD 
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6.6 ”接口 控制 器 的 方法 和 事件 


接口 控制 器 的 ALV 组 件 中 可 以 使 用 下 面 的 方法 : 
€ DATA CHECK. 

@ GET CONFIG DATA. 

e GET MODEL. 

© GET MODEL EXTENDED. 

€ SET DATA. 

还 可 以 使 用 ALV 组 件 的 接口 控制 器 的 下 列 事件 : 
ON AFTER CONFIG. 

ON CELL ACTION. 

ON CLICK. 

ON DATA CHECK. 

ON FUNCTION. 

ON LEAD SELECT. 

ON SELECT. 

ON STD FUNCTION AFTE. 

ON STD FUNCTION BEFO。 


6.6.1 DATA CHECK 


如 果 用 户 在 ALV 输出 中 从 ALV 组 件 Context 节点 上 已 更 改 数据 , 则 将 数据 传输 到 应 用 程 
FF If] Context 市 点 上 时 ， 程 序 员 可 以 使 用 可 编辑 ALV 的 DATA CHECK 方法 。 

SAP 强烈 建议 ， 在 应 用 程序 Context 市 点 绑 定 狐 的 或 已 更 改 的 数据 前 (如 使 用 
BIND TABLE) 使 用 这 种 方法 。 

往往 条 目 要 经 历 儿 个 检查 以 确保 正确 性 ， 如 数据 类 型 和 格式 是 否 正 确 。 


注 : 程序 员 可 以 决定 系统 何 时 会 自动 调用 该 方法 ， 
e 当 用 户 单 击 “ 检 查 ”按钮 
e 当 用 户 选择 返回 或 单 击 另 一 个 单元 格 . 


要 做 到 这 一 点 ， 使 用 方法 IF SALV WD TABLE SETTINGS 一 SET DATA CHECK. 
6.6.2 GET CONFIG DATA 


HP up ERAEVERLEIBIBSHET. )hxe. Dl E. Jr GET CONFIG DATA 返回 
该 用 户 已 经 保存 当前 应 用 程序 的 视图 的 信息 : 
e 哪些 视图 已 保存 到 应 用 程序 了 ? 这 些 视图 名 称 是 什么 ? 
e 视图 现在 是 否 激活 (已 加 载 )? 这 一 视图 名 称 是 什么 ?哪些 设置 已 被 保存 到 这 个 视图 了 ? 
e 作为 初始 视图 ， 用 户 定 义 了 特定 视图 没有 ? 这 一 视图 名 称 是 什么 ?哪些 设置 已 被 保存 
到 这 个 视图 ? 
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e 哪些 视图 属于 哪个 结构 ? (只 适用 于 当 几 个 结构 使 用 SET. DATA 方法 装 入 一 个 ALV 
组 件 时 ) 产生 独特 的 配置 项 ， 并 将 它们 分 配 到 独立 结构 。 

在 configuration key 的 例子 中 ， 可 以 看 到 如 何 生 成 和 分 配 配 置 密 钥 。 

分 配 结构 的 密 钥 ， 必 须 符合 以 下 条 件 : 

e 识别 应 用 程序 中 ALV 输出 的 显示 。 可 以 使 用 S PARAM OUT 中 的 字段 USAGE PATH 
用 于 此 目的 。 

e 它 人 确定 了 在 应 用 程序 中 的 ALV 输出 。 如 果 有 多 个 ALV 输出 显示 在 应 用 程序 中 ， 则 它 
们 必须 能 够 区 分 彼此 。 要 做 到 这 一 点 ， 可 以 使 用 字段 ALV_COMPONENT_USAGE。 

e 使 用 方法 SET_DATA。 它 标识 在 ALV 输出 中 显示 的 结构 。 

要 做 到 这 一 点 ， 可 以 使 用 任何 唯一 的 字符 串 。 

以 下 示例 方法 SET_ALY_CONFIG ID 中 显示 了 所 需要 的 配置 密 钥 的 生成 和 分 配 的 步骤 。 


METHOD SET ALV CONFIG ID. 
[ie] 


DATA: 
L REF IF CONTROLLERTYPE REF TO IWCI SALV WD TABLE, 
LR NODE TYPE REF TOIF WD CONTEXT NODE, 
OWN KEY TYPE STRING. 
*.. GET RELEVANT NODE OF THE APPLICATION CONTEXT 
LR NODE = WD THIS--APPL GET DATA NODRK( ). 


*.. DETERMINE NAME FOR KEY DEPENDING ON THE APPLICATION CONTEXT 
OWN KEY = 'ALVI'. 


* SET NODE OF THE APPLICATION CONTEXT 
L REF IF CONTROLLER-SET DATA(R NODE DATA = LR NODE ). 


* .. CREATE CONFIGURATION KEY CONSISTING OF 
* USAGE PATH, COMPONENT USAGE, OWN KEY 
DATA: 
LS PARAM OUT TYPE IF SALV WD TABLE=>S TYPE PARAM CONFIG OUT, 
LS PARAM IN TYPE IF SALV WD TABLE-^S TYPE PARAM CONFIG IN, 
L KEY TYPE STRING, 
L KEY 32 TYPE STRING. 


LS PARAM IN-ACTION =IF SALV WD TABLE=>KEY. 
LS PARAM OUT-L REF IF CONTROLLER->GET CONFIG DATA(LS PARAM IN). 
CONCATENATE 

LS PARAM OUT-USAGE PATH 

LS PARAM OUT-ALV COMPONENT USAGE 

OWN KEY 
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INTO 
L KEY 
SEPARATED BY '&. 


*.. HASH CONFIGURATION KEY TO UNIQUE KEY OF 32 CHARS LENGTH 
TRY. 
L KEY 32- CL RSMDS HASH UTILITIES--TO HASH C32(L KEY ). 
CATCH CX RSMDS INPUT INVALID CX RSMDS INPUT INVALID TYPE. 
ENDTRY. 


jte] 


* SET NEW CONFIGURATION KEY 
LS PARAM IN-ACTION =IF SALV WD TABLE- SET. 
LS PARAM IN-CONFIG KEY-CONFIG TYPE ='08'. 
LS PARAM IN-CONFIG KEY-CONFIG ID =L KEY 32. 


L REF IF CONTROLLER —GET CONFIG DATA(LS PARAM IN). 


6.6.3 GET MODEL 


方法 GET MODEL 返回 一 个 标准 执行 的 ALV 配置 模型 。 因 此 , 可 以 用 于 配置 ALV 输出 ， 
以 满足 用 户 的 特定 要 求 。 
标准 执行 的 ALV 配置 模型 包含 了 对 应 于 应 用 程序 Context 节点 属性 的 所 有 字段 和 列 对 象 。 


i: 可 以 使 用 GET MODEL EXTENDED 方法 ， 以 确定 是 否 需 要 字段 对 象 或 列 对 象 。 


如 果 用 户 使 用 应 用 程序 配置 ALV 输出 ， 或 者 用 户 改变 了 ALV 输出 ， 则 对 ALV 配置 模型 
有 以 下 影响 : 

e 改变 相应 字段 的 对 象 的 配置 过 滤器 、 排 序 、 聚 集 条 件 。 

e 相应 的 列 的 对 象 被 改变 ， 如 隐藏 和 显示 列 。 

n] DAE FI Zr ik GET. MODEL 调用 当前 状态 的 ALV 输出 与 所 有 的 服务 、 功 能 等 的 设置 。 
通过 这 种 方式 ， 可 以 传输 到 另 一 个 组 件 的 一 个 特定 的 ALV 输出 的 所 有 属性 ， 并 可 以 继续 
处 理 。 

己 经 生成 了 一 个 Context 节点 的 所 有 属性 ， 将 它 与 ALV 组 件 外 部 环境 进行 映射 或 者 使 用 
方法 SET DATA 完成 映射 。 


6.6.4 GET MODEL EXTENDED 


方法 GET MODEL EXTENDED 返回 ALV 配置 模型 。 因 此 ， 可 以 用 其 配置 ALV 输出 ， 
以 满足 用 户 的 特定 要 求 。 在 标准 执行 的 ALV 配置 模型 中 ， 检 索 使 用 GET MODEL 方法 ， 决 
定 是 否 需 要 另外 字段 对 象 的 列 ， 使 用 GET MODEL EXTENDED 方法 。 

己 经 生成 了 一 个 Context 而 点 的 所 有 属性 ， 将 它 与 ALV 组 件 外 部 环境 进行 映射 或 者 使 用 
方法 SET DATA 完成 映射 。 
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6.6.5 SET FOCUS 


为 了 能 够 利用 键盘 使 用 SAP 列表 查看 器 (ALV), ¿EHU € ALV 输出 的 一 行 或 一 单元 格 
上 设置 焦点 。 可 以 通过 各 种 动作 从 ALV 输出 中 删除 焦点 ， 然 后 使 用 方法 SET FOCUS, KE 
点 设置 在 一 个 特定 的 行 或 单元 格 。 

e 如 果 想 将 焦点 设置 到 一 行 ， 则 只 使 用 索引 参数 。 

e 如 果 想 将 焦点 设置 到 一 个 单元 格 ， 则 使 用 参数 索引 和 列 。 


0.0.0 SET DATA 


使 用 方法 SET DATA 有 以 下 两 个 原因 : 
e 要 传输 应 用 程序 Context 数据 到 ALV 组 件 ， 而 不 是 使 用 外 部 环境 映射 。 
e 在 ALV 输出 中 ， 要 显示 的 数据 来 源 于 动态 生成 的 Context 节点 。 


注 : 如 果 随 后 要 指定 另 一 种 结构 到 ALV 输出 中 ， 则 可 以 使 用 方法 SET DATA, 在 这 种 情 
况 下 ， 不 能 在 WDDOINIT 方法 或 另 一 种 标准 方法 中 使 用 该 方法 。 如 果 ALV 输出 已 经 显示 一 
次 ， 则 可 以 只 定义 ALV 组 件 的 事件 处 理 程序 中 的 数据 。 


作为 参数 传输 到 方法 SET DATA 的 Context 节点 必须 是 已 经 存在 的 。 这 与 该 Context 
节点 是 否 在 Web Dynpro 资源 管理 融 中 设计 时 生成 的 ， 还 是 程序 在 运行 过 程 中 目 动 生成 
TXR. 
6.6.7 ON AFTER _ CONFIG 

目前 不 文 持 此 事件 。 
0.0.8 ON CELL ACTION 


默认 情况 下 ， 可 以 使 用 两 个 不 同 的 事件 做 出 反应 ， 用 于 在 列表 区 域 中 与 用 户 交 互 : 

€ ON_CLICKE。 如 单 击 按钮 或 链接 啊 应 交互 ， 不 会 导致 数据 的 变化 。 

€ ON DATA CHECK. 在 变化 的 数据 时 啊 应 区 互 ， 如 选中 复 选 框 或 单 击 切换 按钮 ， 输 入 
InputFields 中 的 条 目 ， 或 从 下 拉 式 列表 框 中 选择 结果 。 

用 户 可 以 设置 SAP 列表 查看 器 (ALV )， 以 便 这 两 种 情况 下 只 有 一 个 事件 被 触发 : 
ON CELL ACTION 事件 。 要 做 到 这 一 点 ， 必 须 相应 地 设 定 系统 。 

如 果 转 换 系 统 到 ON_CELL ACTION， 则 禁用 ON CLICK 事件 的 事件 处 理 程 序 。 事 件 处 
理 程序 仍然 对 ON DATA. CHECK 事件 是 可 用 的 。 

将 系统 切换 到 ON_CELL _ACTION ,和 需 使 用 接口 类 IF_SALV_WD_TABLE_SETTINGS( 实 
现 类 CL SALV WD CONFIG TABLE) 的 方法 ， 见 表 6-104. 


表 6-104 
Ej 能 À 3k 
将 系统 切换 到 ON_CELL ACTION SET CELL ACTION EVENT ENABLED 
检查 系统 是 否 已 经 被 切换 至 ON_CELL _ACTION IS CELL ACTION EVENT ENABLED 
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6.6.9 ON CLICK 


当 用 户 单 击 ALV 输出 中 单元 格 中 的 以 下 UI 元 素 之 一 时 ， 事 件 ON_CLICK 被 触发 : 
e i. 

@ LinkIoAction。 

@ ToggleButton. 


注 : 如 果 方 法 正 SALV WD TABLE SETTINGS—SET CELL ACTION EVENT ENABLED 
设置 为 false， 则 只 触发 ON_CLICK， 否 则 触发 事件 ON CELL ACTION. 


前 提 : 已 注册 此 事件 。 
6.6.10 ON DATA CHECK 


ON DATA CHECK 事件 被 触发 时 ， 在 一 个 可 编辑 ALV 输出 中 检查 已 更 改 的 数据 : 
e 该 用 户 已 插入 或 附加 一 个 或 多 个 行 。 

e 用 户 已 经 删除 了 一 个 或 多 个 行 。 

e 用 户 已 更 改 单元 格 中 的 数据 。 

可 以 进行 数据 校 验 时 定义 : 

e 当 用 户 从 工具 栏 上 单 击 检查 按钮 。 

e 当 用 户 选 择 回 车 或 触发 系统 操作 。 

e 当 执 行 方法 DATA CHECK. 

前 提 : 己 注 册 此 事件 。 


6.6.11 ON FUNCTION 


当 用 户 在 应 用 程序 工具 栏 上 选择 一 个 已 经 自 定义 创建 的 UI 元 素 , 特定 功能 被 触 友 时 的 事 
件 ON. FUNCTION. 


6.6.12 ON LEAD SELECT 


当 用 户 在 ALV 输出 中 更 改 头 选择 时 ，ON_LEAD_SELECT 事件 被 触发 。 
已 经 为 ALV 输出 定义 了 一 个 选择 类 型 ， 人 允许 行 选择 和 修改 头 选择 。 


6.6.13 ON SELECT 


(1) 使 用 

HHF E ALV 输出 中 更 改 头 选择 或 进行 任何 选择 时 ， 触 发 事件 ON_SELECT。 

(2) 先决 条 件 

e 己 经 注册 此 事件 。 

e 在 ALV 配置 模型 中 激活 事件 ON_SELECT。 

可 以 使 用 方法 IF SALV WD TABLE SETTINGS—SET ON SELECT ENABLED 激活 
该 事件 。 
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6.6.14 ON STD FUNCTION AFTE 


CD 使 用 

当 用 户 执行 下 列 操作 之 一 时 ， 和 触发 事件 ON_STD FUNCTION AFTE: 
e 用 户 单 击 设置 对 话 框 中 的 “复制 ”或 “确定 ”按钮 。 

@ 用 户 在 工具 栏 上 单 击 删除 过 滤器 按钮 。 


注 : 可 以 使 用 该 事件 来 确定 用 户 执行 的 标准 ALV 功能 。 


(2) 前 提 
已 注册 此 事件 。 
6.6.18 ON STD FUNCTION BEFO 
CD 使 用 
当 用 户 执行 下 列 操 作 之 一 时 触发 事件 ON_STD FUNCTION BEFO: 
e 用 户 单 击 工 具 柱 中 的 “设置 ”按钮 。 
e 用 户 在 工具 栏 上 单 击 “过 滤器 ”按钮 。 


注 : 可 以 使 用 该 事件 来 确定 用 户 执 行 的 标准 ALV 功能 。 
(2) 前 所 
已 注册 此 事件 。 


6.7 Œ Web Dynpro 应 用 中 使 用 ALV 的 简单 实例 


1) Æ ABAP 工作 台中 的 编辑 界面 创建 Web Dynpro 组 件 。 选 择 “Web Dynpro Comp./Intf”， 
在 相应 的 文本 框 中 输入 程序 的 名 称 ， 如 图 6-6 IR. 


Web Dynpro Comp. / Intf. * 


WD ALV TEST| xls] 
[e> H Ra) Ae 
图 6-6 


创建 Web Dynpro 组 件 如 图 6-7 所 示 。 


Mame ZWD ALV TEST 
Description 考试 成 绩 ALY 表 格 
Type «Web Dynpro Component 


Web Dynpro Component Interface 


Window Name W ALV TEST 
[E 
View Name 
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编辑 Web Dynpro 组 件 如 图 6-8 所 示 。 


Object Name | Description 

7 dà ZWD ALV TEST ”| 考试 成 绩 ALV 表 格 | 
* 4b COMPONENTCONTROLLER | 考试 成 绩 &LV 表 格 ---- 给 件 控制 器 
* «à Component Interface 


- 26 INTERFACECONTROLLER 3& ist pret AL VER- 
| v nterface Views | BE 
_ * E w ALV TEST | 考试 成 绩 ALY 表 格 ---- 窗 体 ——— 
v [F3 views 
* Ed v MAIN | 考试 成 绩 ALY 表 格 ---- 视 图 。 
~ [É3 windows 


WA TEST — SEHGEBALVER E 
6-8 


2) 选择 组 件 哆 zwo ALv TEST ， 选 择 组 件 使 用 选项 卡 ， 添 加 组 件 使 用 如 图 6-9 所 示 。 


Web Dynpro Component [ZWD ALV. TEST | Inactive/revised 
Description | 考试 成 绩 ALV 表 格 

Assistance Class | | 

Created By BCUSER Created On 2013/02/26 
Last Changed By BCUSER Changed On 2013/02/26 
Original Lang. [ZH] Package ZWD TRAINING 


|| Accessibility Checks Active 


. Used Components 上 Implemented interfaces | 


Used Web Dynpro Components 
Component Description of Component 
WDR SELECT. OPTIONS 
T w 
e p^LV WD TABLE Bg 


6-9 
3) FEHHFH hA WFE “Context” WMR, BJ Context 节点 如 图 6-10 所 示 。 


Component Controller COMPONENTCONTROLLER  Active(revised) 
Properties Attributes Events Methads 


Context COMPONENTCONTROLLER 

~ O CONTEXT 

7 [Š] NODE TEST 
* B ZZCLASS 
* "b ZZYEAR 
* "b ZZSTDNO 
* B ZZNAME 
* "i ZZTENKOK 
* "p ZZTENSAN 
* "b zzTEMRIK 
* "b ZZTENSHA 


l 
L3 


6-10 
Context j ri gj lE Ea] 6-11 所 示 。 


LE Change Node 


= 
Node Narne ODE TEST 

Interface Node No ”| 

Input Element (Ext.) No v 

Dictionary structure ZZTEST S 

Cardinality on ”| 

Selection Ü..1 v 

Init. Lead Selection Yes ”| 

Singleton No ”| 

Supply Function | 
Mapping Path 


(^v^ Add attribute from Structure |[X] 
6-11 
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4) 在 左 侧 的 树 形 结构 菜单 上 , 按照 以 下 路 径 双击 组 件 控 制 器 使 用 项 INTERFACECONTROLLER_USAGE|， 
如 图 6-12 所 示 。 
-iĝ 


wv 


^ [n] 


6-12 


选择 “Context” 选 项 卡 ， 将 其 下 的 Context 节点 DATA 映射 到 组 件 控制 器 中 的 Context 
"ai, HHE 6-13 Hn. 
Controller Usage INTERFACECONTROLLER USAGE Inactive(Revised) 
- Properties ^ Context | 


[Rs .- CONTEXT Context COMPONENTCONTROLLER 
* [S] DATA Y O CONTEXT 


= » [5] NODE TEST 
v [5] FILTER. VALUES 


* $ FIELDNAME 

* B T DROPDOWN VALUES 
= E TOP. OF LIST 

* $ CONTENT 
= E] END OF LIST 

* $ CONTENT 


6-13 


映射 结束 如 图 6-14 所 示 。 


[=> Display Mode 


F zi 
Node Name [DATA | 
[E =j z = : 


Interface Made Mo - 


Input Element (Ext. ) Yes * 


Dictionary structure ZZTE M E ü | 


Cardinality ID..n | 

Selection EISE T | 

Init. Lead Selection Yes T 

Singleton Ma x 

Supply Function | ] 

Mapping Path ZWD ALV TEST. COMPONENTCONTROLLER. NODE T. | 

EA 

6-14 


5) 选择 视图 V MAIN， 选 择 “Properties ”选项 卡 ， 添 加 已 声明 要 使 用 的 组 件 如 图 6-15 
所 示 。 
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View 'V MAIN | Inactive(revised) 
Layout Inbound Plugs Outbound Plugs Context Attributes Actions Methods 


Description | 考试 成 绩 ALY 表 格 ---- 视 图 | 
Lifetirne framework contro.. w | 

创建 者 BCUSER 创建 日 期 2013/02/26 

最 后 修改 人 IBCUSER | ”更改 日 其 |2013/02/26| 


h Used Controllers/Cornponents 


Component Use Component Controller Description 


ZWD ALV TEST COMPONENTCONTROLLER 考试 成 顷 &LV 表 格 ---- 蛤 件 控制 器 
4 
hiv TABLE SALV WD TABLE 
ALV TABLE SALV WD TABLE INTERFACECONTROLLER 
SELECT. OPTIONS WDR SELECT OPTIONS 
SELECT. OPTIONS WDR SELECT OPTIONS INTERFACECONTROLLER 
lk 6-15 
` éé : » 、 N i num 
选择 “Atrributes” 选 项 卡 ， 添 加 属性 如 图 6-16 所 示 。 
View "v NAIN | Inactive irevised) 


." Properties Outbound Plugs L Context Actions Methods 


Attribut RefT ü | 参考 打印 Description 


WD CONTEZT [z] IF WD CONTEXT NODE Reference ta Lacal Controller Context 
"UD THIS [v IF V MAIN Self-Reference ta Local Controller Interface 
(4| IG CONMPONENTCONTROLLER 


WD COMP CONTROLLER 


| WD SELECT OPTIONS 


e] 


IF WD SELECT OPTIONS 


= 


图 6-16 


选择 “Context” 选 项 卡 ， 创 建 节 点 NODE TEST HRA E ha HOST] Context Ti 
ZERUR] 6-17 Bras. 


ie "v NAIN | Active(revised) 


properties | Inbound Plugs Outbound Plugs ^ | Attributes | Actions 上 Methods 


Y (O CONTEXT Context COMPONENTCONTROLLER 
MT sO rin |. 0 
' b zzCLASS | * [S] NODE. TEST 
' "B zzYEAR * "b ZZCLASS 
* "3 zZZSTDMO * "i ZZYEAR 
` B ZZNAME * "b ZZSTDNO 
* "s ZZTENEOK « $ ZZNAME 


* "y ZZTENSAN 
* "y Z£ZTEMRIK 
* "3 ZZTENSHA 


* $ ZZTENMKOK 
* "y ZZTENSAN 
* "m ZZTEMRIK 

* "E ZZTENSHA 


图 6-17 
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6) 选择 “Layout” 选 项 卡 ， 添 加 视图 容器 UI 元 素 和 按钮 UI 元 素 ， 如 图 6-18 所 示 。 
布局 编辑 如 图 6-19 所 示 。 


* [| CONTEXT. MENUS 
~ [ ]ROOTUIELEMENTCONTAINER Bri B 
Y L.] GRP. CLASS 


- T CAPTION [Header] ViewContainerUlElement: VCU CLASS 


. Ejvcu cass 
` == BTN SEARCH = 
+ 中 TRY TEST — E 
* T CAPTION 1 [Header] ViewContainerUlElement: VCU TEST 
， Ejvcu TEST 
图 6-18 图 6-19 
为 按钮 添加 动作 ， 如 图 6-20 所 示 。 
[E> Create Action 
Component ZWD ALV TEST 
View v MAIN 
Action SEARCH 
Description rE] 


Select an outbound plug or enter an 
outbound plug far leaving the view 
by selecting the pushbuttan 
Outbound Plug 


u] 


图 6-20 
动作 处 理 方 法 ONACTIONSEARCH 编辑 如 下 : 


METHOD ONACTIONSEARCH . 

DATA LO RANGE ZZCLASS TYPE REF TO DATA. 
FIELD-SYMBOLS: <LFS ZZCLASS» TYPE TABLE. 

DATA LO RANGE ZZYEAR TYPE REF TO DATA. 
FIELD-SYMBOLS: <LFS ZZYEAR» TYPE TABLE. 

DATA LV RCLIKE SY-SUBRC. 

DATA LO ND NODE TEST TYPE REF TOIF WD CONTEXT NODE. 
DATA LT NODE TEST TYPE WD THIS-ELEMENTS NODE TEST. 


CALL METHOD WD THIS->M WD SELECT OPTIONS-GET RANGE TABLE OF SEL FIELD 
EXPORTING 
I ID ='S ZZCLASS' 
RECEIVING 
RT RANGE TABLE - LO RANGE ZZCLASS. 
ASSIGN LO RANGE ZZCLASS-»* TO «LFS ZZCLASS». 
CALL METHOD WD THIS--M WD SELECT OPTIONS—GET RANGE TABLE OF SEL FIELD 
EXPORTING 
I ID ='S ZZYEAR' 
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RECEIVING 
RT RANGE TABLE = LO RANGE ZZYEAR. 
ASSIGN LO RANGE ZZYEAR->* TO «LFS ZZYEAR». 


* navigate from «CONTEXT» to «NODE TEST-^ via lead selection 
LO ND NODE TEST = WD CONTEXT-»GET CHILD NODE( NAME = WD THIS-- 
WDCTX NODE TEST ). 


* @TODO handle non existant child 
* IFlo nd node test IS INITIAL. 
* ENDIF. 
* * (TODO compute values 
SELECT * FROM ZZTEST V 
INTO CORRESPONDING FIELDS OF TABLE LT NODE TEST 
WHERE ZZCLASS IN «LFS ZZCLASS> 
AND ZZYEAR IN «LFS ZZYEAR>. 
* 
LO ND NODE TEST->BIND TABLE( NEW ITEMS =LT NODE TEST SET INITIAL ` 
ELEMENTS = ABAP TRUE ). 
ENDMETHOD. 


WT Jy: WDDOMODIFYVIEW 如 下 : 


METHOD WDDOMODIFYVIEW . 
DATA LO COMPONENTINTERFACE TYPE REF TO IF WD COMPONENT USAGE. 
LO COMPONENTINTERFACE = WD THIS->WD CPUSE SELECT OPTIONS(| ). 
DATA:LT RANGE TYPE REF TO DATA. 

DATA LO INTERFACE TYPE REF TOIWCI WDR SELECT OPTIONS. 
LO INTERFACE = WD THIS->WD CPIFC SELECT OPTIONS( ). 
DATA LO WD SELECT OPTIONS TYPE REF TOIF WD SELECT OPTIONS. 
IF FIRST TIME = ABAP TRUE. 
IF LO COMPONENTINTERFACE--HAS ACTIVE COMPONENT( ) = ABAP FALSE. 
LO COMPONENTINTERFACE--CREATE COMPONENT( ). 
ENDIF. 
CALL METHOD LO INTERFACE-INIT SELECTION SCREEN 
RECEIVING 
R HELPER CLASS-LO WD SELECT OPTIONS. 
CALL METHOD LO WD SELECT OPTIONS-SET GLOBAL OPTIONS 
EXPORTING 
I DISPLAY BTN CANCEL - ABAP FALSE 
I DISPLAY BTN CHECK - ABAP FALSE 
I DISPLAY BTN RESET - ABAP TRUE 
I DISPLAY BTN EXECUTE - ABAP FALSE. 
LT RANGE - 
LO WD SELECT OPTIONSCREATE RANGE TABLE(I TYPENAME ='ZZCLASS E'). 
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CALL METHOD LO WD SELECT OPTIONS-ADD SELECTION FIELD 
EXPORTING 
I ID -'S ZZCLASS' 
IT RESULT = LT RANGE. 
CALL METHOD LO WD SELECT _ OPTIONS->SET GLOBAL OPTIONS 
EXPORTING 
I DISPLAY BTN CANCEL = ABAP FALSE 
I DISPLAY BTN CHECK - ABAP FALSE 
I DISPLAY BTN RESET = ABAP TRUE 
I DISPLAY BTN EXECUTE - ABAP FALSE. 
LT RANGE - 
LO WD SELECT OPTIONS-CREATE RANGE TABLE(I TYPENAME = 'ZZYEAR E'). 
CALL METHOD LO WD SELECT OPTIONS-ADD SELECTION FIELD 
EXPORTING 
LID ='S ZZYEAR 
IT RESULT = LT RANGE. 


WD THIS->M WD SELECT OPTIONS = LO WD SELECT OPTIONS. 
ENDIF. 
ENDMETHOD. 


7) 选择 窗 体 W_ALV_TEST， 选 择 “Window” 选 项 卡 ， 在 视图 容器 UI 元 素 中 添加 使 用 
组 件 中 的 视图 ， 如 图 6-21 所 示 。 


W ALV TEST Inactive(revised) 
Properties ^ Window Inbound Plugs Outbound Plugs Context Attributes Methods 
Window-Struktur Description 
v H-4 p 
Y F] v. MAIN ét pee AL Vsteti 0E] 


~ Ejvcu cLass 
~ FF] WND. SELECTION. SCREEN 
* SU DEFAULT 
~ Ejvcu TEST 
~ Ej TABLE 
* $9 DEFAULT 
* €Z DEFAULT 


图 6-21 


8) 为 组 件 创建 Web Dynpro Apllication， 如 图 6-22 所 示 。 


[> Create Web Dynpro application 


Application zw, alv test 
I 


Description 


图 6-22 
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9) 运行 Web Dynpro 应 用 程序 ， 测 试 显示 结果 ， 如 图 6-23 Wr. 


BIS iS B 
E | 
wk om me[ me 
学 年 e| | 至 | | P 
成 绩 列 表 
View r 
BEER 学 年 学 生 学 号 姓名 语 净 成 绩 数学 成 绩 ERES 思 品 成 绩 [a 
F 1A 0 0 0 0 
(0| 40A 2008 00001 MEE 60 68 70 51 
ET 2008 00002 HBE 62 65 74 83 
Em 2008 00003 金 英 62 65 71 ag 
— |4A 2009 00004 HSE 61 63 75 88 
[XEM 2009 00005 THE 64 66 75 88 
m 14 2009 00006 EDI 64 66 75 88 
Lj] 14 2009 00007 ASE 64 66 76 88 
14 2009 00008 白 喜 医 62 66 72 88 
[3 1A 2008 00008 起 喜庆 62 63 72 82 [vl 
图 6-23 


(J File Edit View Language Document Tools Advanced Window Help 


i E m &il« 4 » n ooi ii«- [3 [II] e - e-l ma 


eie 88 Is é 


CN NN NC NC RNC ED 
pw [em | =] = L = [== 
mm [ex | | «| | = [== 
mm [ws | | «| SL i" [== 


图 6-24 


注意 : 这 里 需要 配置 RFC， 如 图 6-25 所 示 。 
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图 6-25 


EARE, IRAR, WME 6-26 IR. 
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$È AI_DIRECTORY_ECC 


È XITST PORTAL XIP 


图 6-26 


SALV WD EXPORT PDF NSP 
XITST 


图 6-28 


it: 集成 ADOBE FLASH ISLANDS. 文件 操作 、 门户 集成 (PORTAL INTEGRATION ). 
集成 表单 (INTEGRATING FORMS). ALV £ WEB DYNPRO ABAP 的 应 用 均 属 于 Web 
Dynpro For ABAP 集成 技术 。 就 集成 技术 而 言 ， 除 了 以 上 几 种 ，Web Dynpro For ABAP 还 
可 以 与 Office 集成 、 与 BI 集成 、 与 CAF 引导 程序 集成 ， 在 视图 设计 器 中 提供 了 相关 的 


UI 元 素 类 别 整 合 的 功能 。 
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TA 组 件 辅助 类 


对 于 每 一 个 Web Dynpro 组 件 ， 都 可 以 为 其 分 配 一 个 辅助 类 Class。 这 个 类 必须 继承 抽象 
类 CL WD COMPONENT ASSISTANCE。 该 组 件 的 辅助 类 有 以 下 优点 : 

e 程序 员 可 以 编辑 组 件 所 需 的 代码 ， 但 是 这 些 代码 可 以 不 直接 连接 到 视图 View 的 布 

局 或 者 控制 器 的 某 个 功能 。 这 样 就 可 以 实现 应 用 层 的 调用 或 者 基于 用 户 接口 的 数据 
编辑 。 

e 从 性 能 角度 讲 ， 辅 助 类 的 方法 调用 要 好 于 Web Dynpro 控制 器 中 方法 的 调用 。 

e 第 二 个 比较 重要 的 辅助 类 功能 是 用 于 管理 动态 的 文本 文字 。 这 些 文本 文字 在 辅助 类 的 

文本 池 中 作为 文本 符号 (Text Symbols). 存储 ， 只 有 在 运行 时 被 读 取 。 

辅助 类 在 组 件 被 调用 时 自动 被 实例 化 。 该 实例 通过 属性 WD ASSIST 对 于 组 件 中 各 个 控 
制 吉 都 是 有 效 的 。 

类 CL WD COMPONENT ASSISTANCE 提供 中 心 函 数 GET TEXT， 通过 它 ，Web 
Dynpro 组 件 可 以 访问 辅助 类 的 文本 符号 。 使 用 实例 属性 WD ASSIST 和 方法 WD COMPO 
NENT_ASSISTANCE~GET_TEXT()， 程 序 员 可 以 在 组 件 的 各 个 控制 器 读 取 到 辅助 类 的 
文本 符号 。 当 方法 被 调用 时 ， 文 本 符号 的 3 个 字 节 的 数字 ID 通过 KEY 参数 传递 到 方 
kB. 


method MY CONTROLLER METHOD. 
data: my text type string. 
my text= WD ASSIST--IF WD COMPONENT ASSISTANCE-GET TEXT( KEY = ‘001 ). 


endmethod. 


下 面 介绍 编辑 Web Dynpro 应 用 程序 的 方法 。 

通过 上 自 定义 的 组 件 辅助 类 完成 取 值 赋值 操作 的 步骤 如 下 。 

1) 在 ABAP 工作 全 中 的 编辑 界面 创建 Web Dynpro 组 件 。 

选择 “Web Dynpro Comp./Intf.”， 在 相应 的 文本 框 中 输入 程序 的 名 称 ， 如 图 7-1 所 示 。 


Web Dynpro Comp. / Intf. * 


IZWD. ASSISTANCE EA" 
图 7-1 


单 击 图 7-1 (n i bse zs Gp ezg fb, unl 7-2 所 示 。 
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[=> Web Dynpro: Component / Create Interface 


Name | ZWD ASSISTANCE | 
Description 辅助 类 应 用 | 
Type («Web Dynpro Component 


(OWeb Dynpro Component Interface 


Window Name "W ASSI SIANCE | 
View Name (V MAIN | 


I"2E3 
7-2 
编辑 结果 如 图 7-3 所 示 。 
Object Name Description 
= d ZWD ASSISTANCE 辅助 效应 用 


* AË COMPOMENTCONTROLLER | 辅助 类 应 用 --- 姐 件 控 制 器 
* d Component Interface 
* 4 INTERFACECONTROLLEF 辅助 类 应 用 --- 组 件 控 制 器 
~ H Interface Views | — 
* E1w ASSISTANCE | 辅助 类 应 用 --- 窗 慎 
= lE3 Views 
* EË] v MAIN 辅助 类 应 用 一 -视图 
- windows — 
. EJ 


7-3 


2) 在 ABAP 工作 台中 的 编辑 界面 创建 组 件 辅助 类 。 
在 右 侧 树 形 结构 中 双击 组 件 踢 ZWD ASSISTANCE — ， 添 加 组 件 辅助 类 ， 如 图 7-4 所 示 。 


Web Dynpro Component ZWD ASSISTANCE Inactive 
Description | 辅助 类 应 用 
Assistance Class 'ZCL ASSISTANCE | 
Created By BCUSER Created On 2011/10/20 
Last Changed By BCUSER Changed On 2011/10/20 
Original Lang. [ZH] Package ZWD TRAINING 
[V] Accessibility Checks Active 

7-4 


按 《Enter〉 键 创建 ZCL ASSISTANCE， 双 击 进行 编辑 ， 选 择 “Type” 选 项 卡 ， 定 义 类 
型 如 图 7-5 所 示 。 


Klassenschnittstelle ZCL ASSISTANCE 已 实现 / 
/A Eigenschaften 
类 型 可 见 性 “Typisi...，| 参考 打印 说 明 
PARAMS Pubic Type E. 
PARAMS TABLE Pubic Type (> Teten 
Type 
Ta 


单 击 9 | 按钮 ， 自 定义 参数 类 型 如 下 : 
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PUBLIC SECTION. 
TYPES: 
BEGIN OF PARAMS, 
PARA1 TYPE STRING, 
PARA2 TYPE STRING, 


PARA3 TYPE STRING, 
PARA4 TYPE STRING, 
END OF PARAMS. 
TYPES: 
PARAMS TABLE TYPE TABLE OF PARAMS. 


单 击 标准 工具 栏 中 的 扰 按 钮 ， 选 择 “Methoden” 选 项 卡 ， 添 加 自 定 义 方 法 如 图 7-6 所 示 。 


Klassenschnittstelle ZCL ASSISTANCE 已 实现 / 
Eigenschaften V Interfaces | Friends VY Attribute 4 / Ereignisse V Typen 别名 | 


o Parameter [Ë Ausnahmer (Ei E [| (E a |3⁄ | BL. 
方法 £f sl] 可 见 性 类 别 说 明 
IF VD COMPONENT ASSISTAÀ. Insta. Public Liefert einen Text der Model-Klasse 
SET NOT FOUND TEXT KEY Insta.. Protected Setzt den Key f$ den Text bei nicht gefundenem Text 
GET PARAMS TABLE Insta. Public 取得 画面 参数 
| 7-6 


选中 方法 GET PARAMS TABLE, Hi[s Pammeter |] 按钮， 定义 参数 如 图 777 所 示 。 


Klassenschnittstelle ZCL ASSISTANCE ESEM 
Eigenschaften Interfaces Friends Attribute Ereign isse Typen 别名 
parameter zu Methode GET PARAMS TAELE [a |v] 


f B] 

类 型 u... 参考 打印 缺 省 值 说 明 

I NODE Importin. [| | [] Type Re. IF VD CONTEXT. N.. 节点 

E PARAMS TABLE Exporting [v] | O Type PARAMS TABLE 和 参数 表 
| | Type 


图 7-7 
方法 编辑 如 下 : 


METHOD GET PARAMS TABLE. 
DATA LO EL NODE INPUT TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LS PARAMS TYPE PARAMS. 


LO EL NODE INPUT =I NODE->GET ELEMENT( ). 
LO EL NODE INPUT->GET STATIC ATTRIBUTES( 
IMPORTING 
STATIC ATTRIBUTES = LS PARAMS ). 


APPEND LS PARAMS TO E PARAMS TABLE. 
ENDMETHOD. 


Rabb CREPE, EFE "Attribute" AMF, Hh 9 EG. SUE EU 
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性 CONSTANT PARAMS 如 下 : 


CONSTANTS: 


BEGIN OF CONSTANT PARAMS, 
PARAI TYPE STRING VALUE '&PARAI &,, 
PARA2 TYPE STRING VALUE '&PARA2&,, 


PARA3 TYPE STRING VALUE '&PARA3&,, 
PARA4 TYPE STRING VALUE '&PARAA4&,, 
END OF CONSTANT PARAMS. 


编辑 结果 如 图 7-8 所 示 。 


Klassenschnittstelle ZCL ASSISTANCE 已 实现 / 
,/ Eigenschaften V Interfaces Friends Methoden Ereignisse Typen 别名 

| Hu 
属性 级 别 T.. RR |Typisieru... | 参考 打印 说 明 初始 值 | 
CONSTANT PARAMS Constant Public O | > |PARAMS 固 定 值 
CONSTANT PARAMS NO SstaticA.Public [| Type WDR TEXT KEY [ > jweb Dynpro: Text Key '001' 
CONSTANT TAB INDEX  Insanc.Pubic [J Type I [ 9 | 1 

[] Tvpe (>) 


图 7-8 


按照 图 7-9 所 示 的 路 径 定义 文本 元 素 。 
编辑 结果 如 图 7-10 所 示 。 


转 到 (G) 
Class-local types , 
公共 部 分 (P) 

被 保护 部 分 (R) 
TARAA) 
Local Test ClasseS 

O RRD 00000 
Per siscence representatn 
(D) d 
BRE (A) 
38 BK B (O) 
联机 手册 (N) 
返回 (B) 


'ZCL ASSISTANCE | active / revised 


idLen imLen | 
59 59 
0 


Ctrl+F8 
F3 


图 7-9 图 7-10 


3) 在 ABAP 工作 台中 的 编辑 界面 编辑 组 件 。 
单 击 标准 工具 栏 中 的 种 按钮 ,选择 组 件 ZWD ASSISTANCE 视图 V_MAIN 的 “Context” 
选项 卡 ， 添 加 Context 15 ja anl] 7-11 所 示 。 


View 'V MAIN | Inactive(revised) 
Properties Layout Inbound Plugs Outbound Plugs Attributes Actions Methods 
Context V MAIN _ | Ezo ASSTANCECOMPONENTCONTROUER — — — — 
* O CONTEXT Context COMPONENTCONTROLLER 
” [$) NODE_PARAMS - O CONTEXT 
* $ PARAL 
* $ PARA2 
* $ PARA3 
* $ PARA4 
Y [S] NODE TEXT 
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选择 “Layout” 选 项 卡 ， 编 辑 UI 元 素 如 图 7-12 所 示 。 


* L| CONTEXT. MENUS 
= | J]ROOTUIELEMENTCONT AIMER 
= L]GRP ASSIST. TEXT 
* T CAPTION [Header] 
* T PARAI LEL 
* Bg PARAT 
* REPARAZ 
* Bg PARAS 
* Rg PARA4 
* =m BUTTON 
* Q9 HORIZONTAL GUTTER 


* T TEXT LBL 
- EE] TEXT 


图 7-12 


编辑 结果 如 图 7-13 所 示 。 


Ted v _MAIN.NODE_PARAMSI v MAIMMODE PARAMS.] V. MAIN.NODE PARAMS I V. MAIN.NODE PARAMS | | 取得 Text 


Text * MAIM.MODE TEXT.TEXT 


图 7-13 


为 按钮 UI 元 素 添加 动作 如 图 7-14 所 示 。 


Component ZWD ASSISTANCE 
View V MAIN 
m A 
Action GET TEXT — Ü 
Li d 
Description 职 得 Text 


Select an outbound plug or enter an 
outbound plug for leaving the view 

by selecting the pushbutton 
Outbound Plug — e 


加 因 固 


图 7-14 


动作 对 应 处 理 程序 编辑 如 下 : 


METHOD ONACTIONGET TEXT . 
* 取得 参数 并 编辑 内 表 
DATA LO ND NODE PARAMS TYPE REF TOIF WD CONTEXT NODE. 
DATA LS NODE PARAMS TYPE WD THIS->ELEMENT NODE PARAMS. 
DATA LT NODE PARAMS TYPE WD THIS->ELEMENTS NODE PARAMS. 


* navigate from <CONTEXT> to <NODE PARAMS> via lead selection 
LO ND NODE PARAMS= WD CONTEXT->GET CHILD NODE( NAME = WD THIS->WD 


CTX NODE PARAMS). 
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WD ASSIST->GET PARAMS TABLE( 
EXPORTING 
I NODE -LO ND NODE PARAMS 
IMPORTING 
E PARAMS TABLE - LT NODE PARAMS 
) 
READ TABLE LT NODE PARAMS INTO LS NODE PARAMS INDEX 1. 
* 根据 参数 取得 完整 Text 
DATA LO ND NODE TEXT TYPE REF TO IF WD CONTEXT NODE. 
DATA LO EL NODE TEXT TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LS NODE TEXT TYPE WD THIS--ELEMENT NODE TEXT. 


* navigate from «CONTEXT» to «NODE TEXT> via lead selection 
LO ND NODE TEXT = WD CONTEXT-^»GET CHILD NODE( NAME = WD THIS->WD 
CTX NODE TEXT ). 


* get element via lead selection 
LO EL NODE TEXT - LO ND NODE TEXT->GET ELEMENTN( ). 


* (QTODO fill static attributes 
LS NODE TEXT-TEXT = WD ASSIST-IF WD COMPONENT ASSISTANCE-GET TEXT( 
KEY  =zcl assistance=>CONSTANT PARAMS NO 
PARAI =LS NODE PARAMS-PARAIT 
PARA2 =LS NODE PARAMS-PARA2 
PARA3 - LS NODE PARAMS-PARA3 
PARA4 —- LS NODE PARAMS-PARA4 


). 


* setalldeclared attributes 
LO EL NODE TEXT->SET STATIC ATTRIBUTES( 
STATIC ATTRIBUTES = LS NODE TEXT). 
ENDMETHOD. 


转 到 Methods 标签 页 ， 编 辑 钧 子 方 法 WDDOINIT 如 下 : 


METHOD WDDOINIT . 
* Ji t TA [HG 
DATA LO ND NODE PARAMS TYPE REF TOIF WD CONTEXT NODE. 
DATA LO EL NODE PARAMS TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LS NODE PARAMS TYPE WD THIS--ELEMENT NODE PARAMS. 
* navigate from «CONTEXT» to «NODE PARAMS> via lead selection 
LO ND NODE PARAMS = WD CONTEXT--GET CHILD NODE( NAME = WD THIS-^WD 


CTX NODE PARAMS ). 
* get element via lead selection 

LO EL NODE PARAMS - LO ND NODE PARAMS--GET _ ELEMENT( ). 
* (QTODO fill static attributes 

LS NODE PARAMS = WD ASSIST--CONSTANT PARAMS. 


* set all declared attributes 
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LO EL NODE PARAMS-SET STATIC ATTRIBUTES( 
STATIC ATTRIBUTES =LS NODE PARAMS ). 
* 根据 参数 取得 完整 Text 
DATA LO ND NODE TEXT TYPE REF TO IF WD CONTEXT NODE. 
DATA LO EL NODE TEXT TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LS NODE TEXT TYPE WD THIS-ELEMENT NODE TEXT. 


* navigate from «CONTEXT» to «NODE TEXT> via lead selection 
LO ND NODE TEXT = WD CONTEXT-»GET CHILD NODE( NAME = WD THIS-^WDCT 
X NODE TEXT ). 
* get element via lead selection 
LO EL NODE TEXT - LO ND NODE TEXT->GET ELEMENTN( ). 
* (QTODO fill static attributes 
LS NODE TEXT-TEXT = WD ASSIST--IF WD COMPONENT ASSISTANCE-GET TEXT( 
KEY =zcl assistance-2^ CONSTANT PARAMS NO 
PARAI =LS NODE PARAMS-PARAT 
PARA2 - LS NODE PARAMS-PARA2 
PARA3 - LS NODE PARAMS-PARA3 
PARA4 —- LS NODE PARAMS-PARA4 
). 
* set all declared attributes 
LO EL NODE TEXT->SET STATIC ATTRIBUTES( 
STATIC ATTRIBUTES = LS NODE TEXT). 


ENDMETHOD. 


4) 在 ABAP 工作 台中 的 编辑 界面 编辑 Web Dynpro Application, WK] 7-15 所 示 。 


[c Create Web Dynpro application 


Application zwüd assistance 
Description 辅助 尖 应 用 


wis 
图 7-15 
5) 在 ABAP 工作 台 运 行 Web Dynpro Application， 如 图 7-16 所 示 。 
Texte di: &PARA1& |&PARA2& |&PARA3& [&PARA4& 


Text 参数 1: &PARA1& 参数 2: &PARA2& 参数 3: &PARA3& 参数 4: &PARAA4& 


图 7-16 


7.2 Web Dynpro 应 用 中 的 服务 调用 Service Call 


通过 服务 调用 功能 (Service Call) ， 使 得 Web Dynpro 组 件 内 调用 已 存在 的 函数 或 类 中 的 
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H he 

(1) 前 提 (Prerequisites) 

使 用 服务 调用 将 现 有 的 功能 函数 模块 包含 到 当前 的 Web Dynpro 应 用 程序 中 , 可 以 访问 在 
当前 系统 中 可 用 的 函数 。 

(2) 特点 (Features) 

为 了 简化 创建 过 程 ， 在 编辑 环境 中 可 以 使 用 同 导 。 在 访问 导 的 帮助 下 ， 在 所 选择 的 控制 
器 中 目 动 生成 所 需 的 所 有 Context 元 素 。 此 外 ， 该 回 导 会 在 调用 功能 函数 的 控制 句 中 目 动 创建 
一 个 方法 并 确定 传递 的 参数 。 


7.2.1 创建 一 个 Service Call 


要 创建 一 个 服务 调用 , 可 以 使 用 在 ABAP Workbench 中 的 Web Dynpro 工具 内 的 一 个 易于 
使 用 的 向 导 。 

(1) 局 动 问 导 

要 局 动 该 向 导 , 在 工作 全 窗口 的 左 侧 将 光标 定位 在 对 象 列表 中 要 编辑 的 Web Dynpro 组 件 
(ZWD STUDENT)。 单 击 妇 标 右键 ， 打 开 Context 4%, FRE 7-17 所 示 的 路 径 局 动 问 导 。 


Web Dynpro Component (Interface) 


Change View 
Display d Window 
Create/Change Configuration Custom Controller 
Check > : 
.. Activate ^ Mime Objet —— 00» 
Copy... Web Dynpro Application 


Rename... 

Delete 

Where-Used List 

Other Functions , 


7-17 
(2) Xe 
4 |] S I) 8 — oS iE |, REEF da n] EAE IEEE T MC AS VIF CN SUB Wr] bs. KE 
建 一 个 新 的 控制 器 用 于 此 目的 ， 如 图 7-18 所 示 。 


(e) Create New Controller 
O Use Existent Controller 


Component |iZWD STUDENT 


mp = 
Controller CUSTOMCONTROLLER 


7-18 
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È: 服务 调用 只 能 嵌入 到 全 局 控制 器 中 ， 即 在 组 件 控制 器 中 或 自 定义 的 定制 控制 器 中 。 
在 这 一 点 上 ， 一 般 选 择 创建 一 个 新 的 自 定义 控制 器 用 于 保存 数据 。 由 于 是 全 局 控制 器 ， 
因此 它 可 以 被 其 他 控制 器 引用 。 
"anl ea | 按钮 


[= Web Dynpro Wizar ct Servic 


如 图 7-19 所 示 。 


Typ 


O Function Module 
O Assistance Class Method 
‘© Class Method 

OWeb Service Proxy 


71-19 
在 图 7-19 所 示 的 对 话 框 中 可 以 选择 Function Module. Class Method 及 Web Service 
Proxy。 这 里 选中 “Class Method” 单 选 按钮 ， 单 击 国 C sm | 按钮 ， 显 示 的 向 导 页 面 如 


图 7-20 所 示 。 
(3) 必要 的 方法 和 Context 元 素 


Class ZSTDUDENT, CLASS 
Method ZTEST INTERFACE GET NAME 


图 7-20 
rH 22940 ik, Sñ h ea | 按钮 ， 显 示 的 向 导 页 面 如 图 7-21 所 示 。 
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GET NAME . * GET. NAE 
INPORTING . * IMPORTING 
ID . YID 
EXPORTING . Y EXPORTING 
NAME . Y NAME 


7-21 
定义 所 需 Context 节点 ， 单 击 国 ea | 按钮 ， 显 示 的 向 导 页 面 如 图 7-22 所 示 。 


[Parameter Type |Tab Attrbute Type 
ANY ZZNUMBER E 
ANY ZZNANE E 


图 7-22 


B es | 按钮 ， 显 示 的 向 导 页 面 如 图 7-23 所 示 。 


定义 Context 节点 属性 类 型 ， 单 击 


fy Method Name 


[c Web Dynpro Wizard: Speci 


Component ízwD STUDENT ] 
Controller icu STOMCONTROLLER | 
Method [EXECUTE_GET_NANE 


Description 取得 名 称 
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EAEN BRA fin ee  | 按 钮 ， 显 示 的 向 导 页 面 如 图 7-24 
所 示 。 


am 一 
€ 
G am JZ — compete | [X — Abbrechen — ] 


7-24 


BR hA comete | 按钮 ， 完 成 配置 。 

(4) 完成 选项 

当 确 认 最 后 一 个 对 话 框 时 ， 编 码 生 成 费 补 触发。 之 后 就 可 以 使 用 所 配置 的 Web Dynpro 
组 件 所 需 的 方法 和 Context 属性 。 

配置 结果 如 图 7-25 所 示 。 


7 Custom Controllers — 


图 7-25 


配置 时 预定 义 Context 生成 结果 如 图 7-26 所 示 。 


Fustom Controller CUSTOMCONTROLLER Inactive 


- vents vietnhacds 


~ OO CONTEXT 


图 7-26 


配置 时 预定 义 属 性 生成 结果 如 图 7-27 所 示 。 
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Custom Controller CUSTOMCONTROLLER Inactive 


Properties Context A Attributes - Events Methods | 


E|) [36 e) [E [ER (09 [09 


Attribute Public RefTo | TED Description 
JD. CONTEXT | i| IF WD CONTEXT. NODE Reference to Local Controller Context 
WD THIS i 4| IF CUSTOMCONTROLLER Self-Reference to Local Controller Interface 
ID n" | ZZNUMBER E 番号 
M ZSTDUDENT CLASS " v| ZSTDUDENT, CLASS 
NAME m .] ZZNAME E 名 称 
图 7-27 


配置 时 预定 义 方法 生成 结果 如 图 7-28 所 示 。 


Custom Controller CUSTOMCONTROLLER Inactive 
Properties Attributes a—— 


Method Type Description Event Controller 
. 0 Method Y 取得 名 称 

0 Method * Cleanup Method of Controller 

WDDOINIT 0 Method " Initialization Method of Controller 

0 Method * 


图 7-28 
编辑 方法 EXECUTE GET NAME 如 下 : 


METHOD EXECUTE GET NAME. 
IF NOT WD THIS->M ZSTDUDENT CLASS IS BOUND. 
CREATE OBJECT WD THIS->M ZSTDUDENT CLASS. 
ENDIF. 


* declarations for context navigation 
* declarations for parameters 
* get all involved child nodes 


* get input from context 


* the invocation - errors are always fatal !!! 
WD THIS->M ZSTDUDENT CLASS--ZTEST INTERFACE-GET NAME( 
EXPORTING 
ID = WD THIS->ID 
IMPORTING 
NAME - WD THIS->NAME 


). 


* store output to context 


ENDMETHOD. 


7.2.2 ”使 用 Service Call 


(1) 前 提 (Prerequisites) 
已 经 在 已 知 的 组 件 中 定义 服务 调用 。 
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(2) 操作 


RI V3] FS fs FH] E o bn P 2 EE TRI ik Bl ip d «o ER Y EB ALPE" BL 878] 


£E Context 节点 和 属性 外 ， 生 成 的 方法 可 以 跨 控制 器 使 用 。 
(3) 示例 


用 户 硅 想 从 数据 库 表 中 读 取 数据 并 在 现 有 的 功能 模块 的 帮助 下 在 视图 上 显示 它 ， 
在 Web Dynpro 组 件 中 创建 一 个 功能 模块 的 服务 调用 ， 然 后 可 以 看 到 在 选择 作为 全 局 控制 右 
的 Context 视图 中 已 经 创建 了 所 需 的 Context 市 点 和 属性 以 及 调用 功能 模块 的 方法 , 如 图 7-29 


PESE 


Global Controller Global Controller 


Methods 
EXECUTE FUNCMODULE1 
WDDO... 


WDDO... 


Context Methods 


FUNCMODULE1 
Attribute 1 
Attribute 2 


方法 EXECUTE FUNCMODULEI 已 经 自动 生成 。 


图 7-29 


此 时 ， 马 能 模 医 对 于 组 件 是 可 用 的 。 现 在 需要 选择 一 个 视 网 ， 以 便 在 浏 览 堪 中 显示 
数据 库 表 中 的 数据 。 接 看 使 用 选 定 的 视图 控制 右 以 全 局 控制 占 ( 组 件 控制 费 〉 为 输入 。 


随后 ， 上 映射 节点 FUNCMODULI 到 视图 控制 器 Context 中 ， 有 相同 的 名 称 节 点 在 视图 控 


制 器 中 上 自动 生成 ， 如 图 7-30 所 示 。 


Controller myFirstView Global Controller 


Context 

FUNCMODULE 1 
Attribute 1 
Attribute 2 


图 7-30 


Context 


FUNCMODULE 1 
Attribute 1 
Attribute 2 


为 了 将 数据 库 表 中 的 数据 绑 定 到 视图 控制 器 Context 中 Context 节点 的 FUNCMODULI 


上 ， 作 为 全 局 控制 器 的 供给 函数 的 方法 EXECUTE FUNCMODULE1 被 调用 。 要 做 到 这 一 点 ， 
一 个 供给 函数 的 方法 EXECUTE FUNCMODULE1 在 全 局 控制 器 中 被 创建 和 修改 ， 如 


图 7-31 所 示 。 
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Controller of myFirstView: 
Supply Function of Node FUNCMODULET1 


call methad 
EXECUTE FUNCHMODULE1 


global Controller: 
Method EXECUTE. FUNCMODULE! 


call function 
'FUNCMODULE 1 ' 


图 7-31 


1) 在 ABAP THE PHEN NP hri ce ë HE X Fab a HJ J 34 e 
此 例 中 ， 目 定义 控制 器 中 的 Context H FE že, ved HHF XedEBHoEXTS 
制 顷 ， 选 择 “Properties ”选项 卡 ， 设 定 组 件 使 用 如 图 7-32 所 示 。 


Custom Controller CUSTOMCONTROLLER | Inactive 
Context V Attributes V Events V Methods 


Description T I 
创建 者 BCUSER ”创建 日 期 (2011/10/24 
最 后 修改 人 ECUSER | ERAH (2011/10/24 


Used Controllers/ Components 


Component Use Component Controller Description 
ZWD STUDENT COMPONENTCONTROLLER 学 生 信 息 扒 护 --- 蛤 件 控制 器 


WFE “Context” 选项 卡 , 将 节点 NODE STUDENT 拖 至 GET NAME E, 为 GET NAME 
创建 属性 并 上 映射， 如 图 7-33 所 示 。 


Custom Controller CUSTOMCONTROLLER Inactive(revised) 
Properties Attributes | Events | Methods | 
Context CUSTOMCONTROLLER (fázwb STUDENT.COMPONENTCONTROLER —— — — — — — 
7 O CONTEXT Context COMPONENTCONTROLLER 
~ [E] GET NAME ~ © CONTEXT 
* $ ZZNUMBER Y [5] NODE STUDENT 
* $ ZZNAME * $ ZZNUMBER 
* "3 ZZNAME 
* b ZZSEX 
* "i3 ZZFNAME 
* ® ZZMNAME 
* $ ZZMOBILE 
* $ ZZADDR 
* tb ZZNOTE 
» Œ NODE NEXT. OPT 


ME: 该 处 为 部 分 映射 。 
选择 “Methods” 选 项 卡 ， 编 辑 方法 EXECUTE GET NAME 如 下 : 
METHOD EXECUTE GET NAME. 


IF NOT WD THIS->M ZSTDUDENT CLASS IS BOUND. 


CREATE OBJECT WD THIS->M ZSTDUDENT CLASS. 
ENDIF. 
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* declarations for context navigation 
DATA LO ND GET NAME TYPE REF TOIF WD CONTEXT NODE. 


DATA LO EL GET NAME TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LS GET NAME TYPE WD THIS--ELEMENT GET NAME. 
* navigate from «CONTEXT» to «GET NAME? via lead selection 
LO ND GET NAME = WD CONTEXT->GET CHILD NODE( NAME = WD THIS-> 
WDCTX GET NAME ). 
* get element via lead selection 
LO EL GET NAME - LO ND GET NAME->GET ELEMENTN( ). 
* get all declared attributes 
LO EL GET NAME->GET STATIC ATTRIBUTES( 
IMPORTING 
STATIC ATTRIBUTES = LS GET NAME). 
* declarations for parameters 
WD THIS->ID= LS GET NAME-ZZNUMBER. 
* the invocation - errors are always fatal !!! 
WD THIS->M ZSTDUDENT CLASS--ZTEST INTERFACE-GET NAME( 
EXPORTING 
ID = WD THIS->ID 


IMPORTING 
NAME = WD THIS--NAME 


* store output to context 
LS GET NAME-ZZNAME = WD THIS-^2NAME. 
LO EL GET NAME->SET STATIC ATTRIBUTES( 
EXPORTING 
STATIC ATTRIBUTES - LS GET NAME). 
ENDMETHOD. 


2) 在 ABAP TL TES PRIKA, TETULES "nS H] BILE XPRESS ZI 3 - 
选择 视图 V STUDENT DEL， 选 择 “Properties” 选 项 卡 ， 设 定 组 件 使 用 如 图 7-34 所 示 。 


View Y STUDENT DEL Active(revised) 
." Properties Layout p Inbound Plugs y Outbound Plugs ¥ Context V Attributes y Actions / Methods 


Description 学 生 信 息 维护 一 删除 视图 

Lifetime framework contro.. w 

创建 者 BCUSER 创建 日 期 2011/10/21 

FREA BCUSER 更 改 日 期 2011/10/24 

mE 

Used Controllers/ Components 

Component Use Component Controller Description 
ZWD STUDENT COMPONENTCONTROLLER 学 生 信息 维护 -- 姐 件 控制 器 
ZWD STUDENT CUSTOMCONTROLLER 学 生 信 息 查 询 -一 自 定 愉 控 制 器 


图 7-34 
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选择 “methods” 选 项 卡 ， 编 辑 钩子 方法 WDDOMODIFYVIEW 如 下 : 


METHOD WDDOMODIFY VIEW . 
DATA LO CUSTOMCONTROLLER TYPE REF TO IG CUSTOMCONTROLLER . 
LO CUSTOMCONTROLLER- WD THIS->GET CUSTOMCONTROLLER CTR( ). 


LO CUSTOMCONTROLLER-—EXECUTE GET NAME( ). 
ENDMETHOD. 


选择 视 钢 V_STUDENT_UPD， 按 照 同样 的 步骤 完善 组 件 功能 操作 。 

3) 在 ABAP 工作 台中 的 Web Dynpro Application 编辑 界面 ， 测 试 在 视图 中 调用 目 定 义 控 
制 器 的 方法 。 

运行 Web Dynpro， 应 用 zwd student del， 如 图 7-35 所 示 。 


学 生 信 息 
键 值 信息 
学 生 学 号 : |00002 — [3 
Tta 
[确定 | 


图 7-35 


输入 学 生 学 号 ， 并 单 击 [确定 | 按钮 ， 如 图 7-36 所 示 。 


学 生 信 息 
键 值 信息 
学 生 学 号 : |00002 
tà: MEE 
主体 信息 
性 别 : 男性 
Sess: Nó 
母亲 : Sj SP 
联系 电话 : 139876X X X xx 


家 庭 住 址 : 北京 鲁迅 路 129 号 
备注 : 修改 后 


[保存 |] 
图 7-36 


运行 Web Dynpro, VH] zwd student upd， 如 图 7-37 所 示 。 


学 生 信 息 
键 值 信息 
学 生 学 号 : |00003 a 
姓名 : | 
[确定 | 


图 7-37 
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输入 学 生 学 号 ， 并 单 击 [确定 | 按钮 ， 如 图 7-38 所 示 。 


学 生 信 息 
键 值 信息 
学 生 学 号 . 00003 
姓名 : Er 


性 别 : zE M 
3% BA | 
ap Wa | 
联系 电话 :| 1390754557 

家 庭 住址 : | 北京 鲁迅 路 130 号 

备 


图 7-38 


T.9 ”使 用 对 话 框 


对 话 框 在 Web Dynpro 视图 上 ， 用 于 显示 具体 的 信息 或 可 能 的 设置 。 对 话 框 退出 后 ， 对 话 
框 下 的 视图 被 激活 ， 或 跳 转 到 另 一 个 试图 。 有 以 下 两 种 不 同类 型 的 对 话 框 : 
1) 模 态 对 话 框 (Modal)。 在 当前 浏览 器 窗口 中 打开 一 个 模 态 对 话 框 。 


注意 : 每 一 个 模 态 对 话 框 都 有 自己 的 阶段 模型 实例 。 


2) 外 部 对 话 框 。 外 部 对 话 杠 在 一 个 单独 的 浏览 右 窗 口中 打开 ， 并 且 独 立 于 诛 来 的 窗口 ， 
可 以 在 屏幕 上 移动 。 

在 Web Dynpro 应 用 程序 中 ,对话 框 都 是 通过 一 个 额外 的 窗口 实现 的 ,并 且 一 般 都 在 一 个 
动作 的 事件 处 理 程序 中 被 调用 〈 如 有 必要 ， 在 阶段 模型 的 所 有 其 他 方法 中 都 可 以 使 用 )。 组 件 
控制 占 包 含 接口 IF WD WINDOW_MANAGER， 使 用 它 可 以 创建 并 打开 一 个 新 窗口 的 对 话 
HE 《在 创建 过 程 中 ， 相 应 的 组 件 控制 右 的 使 用 为 每 个 视图 控制 右 目 动 设置 )。 在 大 多 数 情况 
下 ， 在 应 用 程序 中 使 用 一 个 模 态 对 话 框 。 


注 : 不 再 使 用 的 参数 MODAL. 


集成 的 控件 UI 元 素 不 支持 Web Dynpro ABAP 对 话 框 。 集 成 的 所 有 的 UI 元 素 继 承 
AbstractActiveComponent 组 件 。 

e Gantt (HFE); 

€ Network (网 络 )。 

€ OfficeControl (办 公 控 制 )。 

€ InteractiveForm 〈 交 互 报表 )。 
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7.3.4. 同一 组 件 中 调用 对 话 框 


如 果 用 户 想 显示 对 话 框 ， 则 相关 内 容 要 连接 到 当前 组 件 ， 以 此 为 目的 ， 程 序 员 应 该 在 这 
个 组 件 中 创建 相应 的 窗 体 。 

接口 WD WINDOW MANAGER If] CREATE WINDOW 方法 允许 程序 员 在 事件 处 理 
程序 方法 中 ， 在 运行 时 显示 的 窗 体 上 创建 一 个 对 话 框 。 打 开 的 对 话 框 窗 体 的 名 称 作 为 参数 传 
递 给 CREATE WINDOW 方法 。 属 性 类 型 IF WD WINDOW 必须 在 视图 控制 器 中 声明 作为 
对 话 框 。 在 下 面 的 例子 中 ， 这 是 属性 m popupl 1， 如 图 7-39 所 示 。 


wiew VIEM 1 Inactive(revised) 


Properties Layout Inbound Plugs Outbaund Plugs context 


n C pe Type 
demum man a s: CONPONENTCONTROLLER 


图 7-39 


用 作 该 对 话 框 (在 这 种 情况 下 ，POPUP1 D 的 窗 体 必须 已 经 在 组 件 中 存在 。 


method onactionpopupl 1. 
data:] cmp api type refto if wd component, 
] window manager type ref to if wd window manager. 
l cmp api = wd comp controller-^wd get api( ). 
] window manager -] cmp apl->get window manager( ). 
if wd this-^m popupl 1 is initial. 


wd this->m popupl 1-1 window manager-»create window( 
window name = 'POPUPI 1 


button kind 2^ if wd window-»co buttons yesnocancel 


message type =1f wd window-»co msg type question ). 
endif. 
wd this-^m popupl 1->open( ). 


endmethod. "onactionpopupl 1 


it: CREATE WINDOW 方法 仅 创 建 了 新 的 对 话 框 ， 它 不 会 打开 它 。 要 打开 对 话 框 ， 还 
需要 OPEN 方法 ， 


(1) 对 话 框 按钮 

可 以 使 用 BUTTON_KIND 参数 指定 哪些 按钮 出 现在 对 话 框 中 。 在 上 面 的 例子 中 , 设置 的 
CO BUTTONS YESNOCANCEL 常量 。 这 个 音量 是 ABAP 字典 中 类 型 的 域 为 WDR POPUP ` 
BUTTON KIND 的 常量 ， 该 域 中 有 一 组 固定 值 。 固 定 值 代表 所 有 的 有 意义 的 可 能 性 对 话 框 按 
钮 组 合 ， 如 OK、OK/Cancel 或 Yes/No/Cancel 的 常数 ， 作 为 IF WD WINDOW 接口 的 属性 ， 
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默认 值 是 S。 这 意味 着 ， 该 组 合 包含 常量 CO BUTTON YES. CO BUTTON NO 和 CO ` 
BUTTON CANCEL， 而 且 在 对 话 框 中 将 创建 3 个 按钮 ， 分 别 代 表 “Yes”“No” 和 “Cancel”。 
(2) 窗 体 对 话 框 
在 对 话 框 视图 的 WDDOINIT 方法 中 ,要 将 按键 常数 链接 到 适当 的 动作 Action。 为 了 这 个 
目的 ， 可 使 用 接口 正 WD WINDOW 中 的 SUBSCRIBE TO BUTTON EVENT 方法 。 相 应 动 
作 都 必须 在 该 对 话 框 中 直接 创建 ， 目 动 创建 的 事件 处 理 程序 方法 必须 进行 相应 的 编程 。 


method wddoinit . 
data: 
l api type ref to if wd view controller, 
] window ctlr type ref to if wd window controller, 
] popup type ref to if wd window. 
l api = wd this-^wd get api( ). 
] window ctlr =] api-^get embedding window ctlr( ). 
ifl window ctlr is bound. 
] popup =1 window ctlr-^get window( ). 
ifl popup is bound. 
] popup-^subscribe to button event( 
button = if wd window-»co button yes 
button text — 'Yes' 
action name = 'YES' 
action view =]! api 
is default button = abap true ). 
] popup-^subscribe to button event( 
button = if wd window-»co button no 
button text = 'No' 
action name = 'NO' 
action view =] api 
is default button = abap true ). 
] popup-^subscribe to button event( 
button = if wd window-»co button cancel 


button text = 'Cancel' 
action name = 'CANCEL' 


action view =l api 


is default button = abap true ). 
endif. 
endif. 
endmethod. "wddoinit 


action name = 'CANCEL' 
action view =| api 
is default button = abap true ). 
endif. 
endif. 
endmethod. "wddoinit 
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Hs 该 对 话 框 阶段 模型 的 实例 被 连接 到 相同 组 件 的 调用 窗 体 的 实例 中 。 出 于 这 个 原因 ， 
打开 对 话 框 时 ， 不 仅 所 有 对 话 框 中 视图 的 钓 子 方法 被 调用 ， 髓 入 窗 体 的 所 有 视图 的 钓 子 方法 
也 被 调用 。 


(3) WDDOONOPEN 和 WDDOONCLOSE 方法 

每 个 窗 体 控制 器 具有 WDDOONOPEN 和 WDDOONCLOSE 钩子 方法 。 这 两 个 方法 都 只 
能 在 一 个 窗 体 作为 一 个 对 话 框 被 打开 或 关闭 时 处 理 。 由 于 打开 一 个 对 话 框 不 涉及 任何 导航 ， 
没有 入 站 插头 被 调用 ， 因 此 没有 事件 处 理 程 序 方法 被 处 理 。WDDOONOPEN 方法 可 以 用 于 实 
施 初 始 化 。 


7.3.2 ”调用 使 用 组 件 的 对 话 框 


如 果 对 话 框 要 显示 的 是 一 个 通用 画面 ， 则 该 对 话 框 可 以 用 在 许多 不 同 的 组 件 ， 程 序 员 可 
以 创建 一 个 单独 的 组 件 ， 然 后 在 相应 的 窗 体 中 使 用 该 对 话 框 。 在 这 种 情况 下 ， 在 运行 时 创建 
对 话 框 ， 在 当前 的 组 件 中 使 用 方法 CREATE WINDOW FOR CMP USAGE 并 将 接口 视图 和 
组 件 使 用 的 名 称 z 作为 传递 参数 。 前 提 是 该 对 话 框 所 属 的 组 件 的 属性 表 中 必须 有 一 个 组 件 使 
用 的 条 目 。 


method onactionpopup2 1. 


data:] cmp api type refto if wd component, 

] window manager type ref to if wd window manager. 

l] cmp api = wd comp controller-^wd get api( ). 

] window manager =l] cmp apl->get window manager( ). 

if wd this-^m popup2 1 is initial. 
wd this-»m popup2 1-1 window manager-^create window for cmp usage( 
interface view name = 'MAIN' 
component usage name = USAGE POPUP2 1'). 

endif. 

wd this-^m popup2 1->open( ). 

endmethod. "ONACTIONPOPUP2 1 


E ARHAR X ui IR], ESL LAS PERS yur, ABE BIEE—^ TFI ER 
按钮 。 因 为 按钮 只 能 由 所 属 的 组 件 设置 。 这 一 步 是 在 声明 对 话 框 使 用 的 其 他 组 件 的 窗 体 控制 
圳 的 钩子 函数 WDDOONOPEN 中 实现 的 。 

下 面 的 源 代码 的 方法 WDDOOPEN， 实 现 控制 器 上 的 对 话 框 : 


method wddoonopen . 

if window descr->ls popup = abap true. 
window descr-window-»set button kind( 
if wd window-»co buttons yesnocancel ). 
window descr window-»set message type( 
if wd window=>co msg type question 
). 

endif. 


endmethod. "wddoonopen 
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注 : 如 果 该 对 话 框 不 是 独立 的 组 件 的 一 部 分 ， 但 在 组 件 使 用 中 被 创建 ， 则 两 个 窗 体 的 阶 
段 模型 实例 无 法 连接 到 相同 的 组 件 。 如 果 该 对 话 框 是 开放 的 ， 则 只 有 中 上 诅 入 对 话 框 中 视图 的 
钩子 方法 被 处 理 。 


733 ”调用 确认 对 话 框 


要 快速 创建 一 个 确认 对 话 框 的 标准 布局 (如 确认 当前 数据 的 变化 )， 程 序 员 可 以 调用 接口 
IF WD WINDOW MANAGER 的 CREATE POPUP TO CONFIRM 的 方法 。 该 方法 不 需要 创 
建 一 个 单独 的 窗 体 ， 运 行 时 会 日 动 创建 该 对 话 框 。 

使 用 CREATE POPUP TO CONFIRM 方法 创建 对 象 的 类 型 为 下 _WD_WINDOW， 对 话 
框 可 以 使 用 它 的 参数 。 


method onactionpopup4 1. 


data:] cmp api type ref to if wd component, 
] window manager — typereftoif wd window manager, 
] popup type ref to if wd window, 
] text type string table, 
] api type ref to if wd view controller. 


] cmp api — wd comp controller-^wd get api( ). 

] window manager =] cmp apl->get window manager( ). 

insert Data where changed' into table] text. "REC * 

insert Do you want to save? into table] text. "REC * 


] popup =l] window manager-»create popup to confirm( 
text —] text 
button kind —1f wd window-»co buttons yesnocancel 
message type =1f wd window-»co msg type question 
window title = 'Test: Popup to confirm' 


window position = if wd window-»co center )."ZEC * 


l api = wd this-^wd get api( ). 


] popup-^subscribe to button event( 
button =1f wd window-»co button yes 
action name -'YES 
action view —] api 
is default button = abap true ). 
] popup-^subscribe to button event( 
button =1f wd window-»co button no 
action name = 'NO!' 
action. view —] api 


is default button = abap false ). 
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] popup-^subscribe to button event( 
button =1f wd window=>co button cancel 
action name = CANCEL 


action view —] api 


is default button = abap false ). 


] popup-^open( ). 
endmethod. 


接口 Ff WD WINDOW 的 方法 SUBSCRIBE TO BUTTON EVENT 分 配 相 应 的 按钮 到 动 
作 。 如 果 已 经 为 对 话 框 创建 了 一 个 窗 体 ， 在 钩子 方法 WDDOINIT 中 将 动作 分 配给 按钮 。 
e 如 果 没 有 明确 创建 窗 体 的 存在 ， 则 相应 的 操作 是 建立 在 同一 个 视图 中 调用 对 话 框 。 分 
配 使 用 的 方法 SUBSCRIBE TO BUTTON EVENT 在 创建 的 对 话 框 后 调用 。 
e 对 于 一 些 特殊 情况 ， 它 可 以 用 来 对 组 件 控制 器 或 定制 控制 器 的 对 话 框 上 的 按钮 事件 注 
册 事 件 处 理 程序 。 在 这 些 情况 下 ， 接 口 IF WD POPUP TO CONFIRM N 的 特殊 属 
性 POPUP_TO_CONFIRM 在 正 WD WINDOW 接口 中 被 实施 。 这 个 接口 提供 了 精确 
的 方法 ， 组 件 和 定制 的 控制 器 中 的 事件 处 理 程序 可 以 注册 到 对 话 框 事件 中 。 
D 选择 组 件 ZWD STUDENT 中 的 视图 V_ STUDENT _ DEL， 选择 “Attributes” 选 项 卡 ， 
WIETE FLAG DEL, n 7-40 所 示 。 


View Y STUDENT DEL Active(revised) 
Properties Layout Inbound Plugs Outbound Plugs Context Actions Methods 


Attribute RefTo | #=#TED Description 
WD CONTEXT 4| IF VD CONTEXT. NODE Reference to Local Controller Ct 
WD THIS M IF V STUDENT DEL Self-Reference to Local Controll 
WD COMP CONTROLLER «| IG COMPONENTCONTROLLER 
NEXT OPT [] STRING 操作 
FLAC_DEL [| WDY BOOLEAN 册 除 确认 

图 7-40 


选择 “Actions” 选 项 卡 ， 添 加 动作 YES、NO、CANCEL， 如 图 7-41 所 示 。 


View Y STUDENT. DEL Active(revised) 
| Outbound Plugs V Context ` 


Attributes ^ Methods 


P roperties 


| ©- | Ji |i 

ER Action Type X Description Event Handler 
CONFIRM standard Y MERHER ONACTIONCONFIRM 
SÀVE standard ™ FÆ BIRF ONACTIONSAVE 
YES standard "IE ONACTIONYES 
NO standard v 不 删除 ONACTIONNO 
CANCEL standard * 取消 ONACTIONCANCEL 

standard v 
图 7-41 


动作 YES 对 应 处 理 程 序 编辑 如 下 : 
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METHOD ONACTIONYES . 


WD THIS->FLAG DEL = ABAP TRUE. 
ENDMETHOD. 


动作 NO 对 应 处 理 程 序 编辑 如 下 : 


METHOD ONACTIONNO . 


WD THIS->FLAG DEL = ABAP FALSE. 
ENDMETHOD. 


动作 CANCEL 对 应 处 理 程序 编辑 如 下 : 


METHOD ONACTIONCANCEL . 


WD THIS->FLAG DEL = ABAP FALSE. 
ENDMETHOD. 


选择 “Methods” 选 项 卡 ， 添 加 方法 POPUP TO CONFIRM, Jl 7-42 所 示 。 


View WV _STUDENT_DEL Active(revised) 


Properties k Layout k Inbound Plugs | Outbound Plugs K“ Context 


^ Attributes Actions 


EJ Li. HIE 


Method Type |Description Event Controller 


, | = 


Method 


HANDLEFROM WINDOW Event H. € 从 窗 性 到 视图 

ONACTIONCONFIRM Event H. Y MEENA 

ONACTIONSAVE Event H. ~ FERRIT 

WDDOARFTERACTION Method "w 

WDDOBEROREACTION Method ™ 

WDDOEX IT Method — * Cleanup Method of Controller 

WDDOINIT Method * Initialization Method of Controller 
WDDONODIPFYVIEW Method * Method for Modifying the View Before Rendering 
WDDOONCONTEXTMENU Method — "* 


POPUP TO CONFIRM Method ~ HEHA 
Method hal 


图 7-42 
方法 POPUP TO CONFIRM 编辑 如 下 : 


METHOD POPUP TO CONFIRM . 
DATA: L CMP API TYPE REF TO IF WD COMPONENT, 
L WINDOW MANAGER TYPE REF TO IF WD WINDOW MANAGER, 
L POPUP TYPE REF TO IF WD WINDOW, 
L TEXT TYPE STRING TABLE, 
L API TYPE REF TOIF WD VIEW CONTROLLER. 


* BUS EAT 
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L CMP API- WD COMP CONTROLLER- WD GET API(). 
L WINDOW MANAGER = L CMP API--GET WINDOW MANAGER( ). 


编辑 警示 Text 
INSERT ' 确 认 ! ' INTO TABLE L TEXT. 
INSERT ' 确 实 要 删除 吗 ? ' INTO TABLE L TEXT. 


创建 窗 体 
L POPUP=L WINDOW MANAGER->CREATE POPUP TO CONFIRM( 
TEXT- L TEXT 
BUTTON KIND =IF WD WINDOW=>CO BUTTONS YESNOCANCEL 
MESSAGE _ TYPE =IF WD WINDOW=>CO MSG TYPE QUESTION 
WINDOW TITLE = ' 删 除 确认 ， 
WINDOW POSITION - IF WD WINDOW--CO CENTER). 


取得 视图 控制 右 
L API- WD THIS->WD GET API(). 


编辑 按钮 

L POPUP->SUBSCRIBE TO BUTTON EVENT( 
BUTTON -IF WD WINDOW--CO BUTTON YES 
ACTION NAME - 'YES' 
ACTION VIEW = L API 
IS DEFAULT BUTTON = ABAP TRUE). 
L POPUP-SUBSCRIBE TO BUTTON EVENT( 
BUTTON = IF WD WINDOW--CO BUTTON NO 
ACTION NAME = 'NO! 
ACTION VIEW = L. API 
IS DEFAULT BUTTON = ABAP FALSE). 
L POPUP-SUBSCRIBE TO BUTTON EVENT( 
BUTTON -IF WD _ WINDOW=>CO BUTTON CANCEL 
ACTION NAME = 'CANCEL' 
ACTION VIEW = L API 
IS DEFAULT BUTTON = ABAP FALSE). 

* 弹出 窗 体 
L POPUP->OPEN( ). 


ENDMETHOD. 


修改 动作 SAVE 处 理 程序 如 下 删除 之 前 确认 ): 


METHOD ONACTIONSAVE . 
DATA LO COMPONENTCONTROLLER TYPE REF TO IG COMPONENTCONTROLLER . 
LO COMPONENTCONTROLLER- WD THIS>GET COMPONENTCONTROLLER CTR(). 


DATA LS STUDENT TYPE ZMNUMBER T. 
LO COMPONENTCONTROLLER--GET STUDENT( 
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IMPORTING 
STUDENT= LS STUDENT "zmnumber t 
). 
DATA LO ND NODE CONFIG TYPE REF TOIF WD CONTEXT NODE. 
DATA LO EL NODE CONFIG TYPE REF TO IF WD CONTEXT ELEMENT. 
DATA LS NODE CONFIG TYPE WD THIS--ELEMENT NODE CONFIG. 


* navigate from «CONTEXT» to «NODE CONFIG?- via lead selection 
LO ND NODE CONFIG = WD _ CONTEXT->GET CHILD NODE( NAME = WD THIS-> 
WDCTX NODE CONFIG ). 


* get element via lead selection 
LO EL NODE CONFIG - LO ND NODE CONFIG-^GET ELEMENTN( ). 


CASE WD THIS->NEXT OPT. 

WHEN 'ADD'. 
INSERT ZMNUMBER T FROM LS STUDENT. 
LS NODE CONFIG-BODY READONLY - ABAP FALSE. 
LS NODE CONFIG-KEY READONLY =ABAP FALSE. 
LS NODE CONFIG-BODY VISIBILE = CL WD GROUP=>E VISIBLE-VISIBLE. 
LS NODE CONFIG-CONFIRM VISIBILE = CL WD GROUP=>E VISIBLE-NONE . 
LS NODE CONFIG-SAVE VISIBILE = CL WD GROUP=>E VISIBLE-VISIBLE. 

WHEN 'UPD.. 
UPDATE ZMNUMBER T FROM LS STUDENT. 
LS NODE CONFIG-BODY READONLY - ABAP FALSE. 
LS NODE CONFIG-KEY READONLY  -ABAP FALSE. 
LS NODE CONFIG-BODY VISIBILE = CL WD GROUP=>E VISIBLE-NONE. 
LS NODE CONFIG-CONFIRM VISIBILE = CL WD GROUP=>E VISIBLE-VISIBLE. 
LS NODE CONFIG-SAVE VISIBILE = CL WD GROUP=>E VISIBLE-NONE. 

WHEN OTHERS. 

Š 删除 确认 
WD THIS->POPUP TO CONFIRM( 
) 
* 确认 删除 

CHECK WD THIS->FLAG DEL = ABAP TRUE. 
DELETE ZMNUMBER TFROM LS STUDENT. 
LS NODE CONFIG-BODY READONLY = ABAP TRUE. 
LS NODE CONFIG-KEY READONLY =ABAP FALSE. 
LS NODE CONFIG-BODY VISIBILE = CL WD GROUP=>E VISIBLE-NONE. 
LS NODE CONFIG-CONFIRM VISIBILE = CL WD GROUP=>E VISIBLE-VISIBLE. 
LS NODE CONFIG-SAVE VISIBILE = CL WD GROUP=>E VISIBLE-NONE. 


ENDCASE. 


* set all declared attributes 
LO EL NODE CONFIG-^SET STATIC ATTRIBUTES( 
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STATIC ATTRIBUTES = LS NODE CONFIG ). 


* ”解锁 
CALL FUNCTION 'DEQUEUE EZMNUMBER T' 
EXPORTING 
MODE ZMNUMBER T = 'E' 
MANDT = SY-MANDT 
ZZNUMBER -LS STUDENT-ZZNUMBER 
X ZZNUMBER ='' 
_SCOPE = 
_SYNCHRON 
_COLLECT 


ENDMETHOD. 


2) 选择 组 件 应 用 zwd student del， 运 行 结果 ， 如 图 7-43 所 示 。 


FERE 
Bibi B 


xi CTH - [amma 
学 生 学 号 : 00012 


MESS. Toe ES 


确认 
确实 要 册 降 吧 ? 


EHRE 

性 别 : 男性 
MES o XE 
HF: Et 


RB TER: 
£t 更 新 


图 7-43 


1.4 输入 帮助 


在 交互 式 业 务 应 用 程序 的 环境 中 ， 由 用 户 输 入 的 数据 是 非常 重要 的 。 在 大 量 的 对 话 框 变 
式 中 ， 一 个 有 效 的 输入 表示 一 个 有 限制 的 一 组 值 的 一 个 元 系 。 用 户 可 以 从 一 个 包含 可 能 值 的 
表 中 选择 所 需 的 值 。 


注 : 输入 帮助 也 被 称 为 值 帮助 、 搜 索 帮 助 、F4 帮助 等 ， 


(1) Web Dynpro ABAP 的 输入 帮助 
一 旦 输入 帮助 集成 的 Web Dynpro 框架 自动 生成 , 就 实现 关联 图 标 ,， 以便 用 户 在 运行 时 选 
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择 调 用 输入 帮助 。 同 时 ，F4 键 会 日 动 分 配给 系统 ， 用 于 调用 输入 帮助 。 

有 许多 不 同类 型 的 输入 帮助 。 用 户 选 择 哪 种 类 型 的 输入 帮助 依赖 于 相应 的 应 用 程序 。 

Web Dynpro ABAP 框架 提供 了 两 种 实现 输入 帮助 的 方法 : 

1) ABAP 字典 搜索 帮助 。 该 输入 帮助 是 基于 SAP 系统 的 ABAP 字典 中 的 搜索 帮助 功能 。 
因此 用 户 可 以 使 用 ABAP 字典 中 的 数据 元 素 搜 索 帮助 的 定义 ， 只 要 这 些 文 持 Web Dynpro。 

2) OVS 值 帮助 。 

如 果 不 能 使 用 ABAP 词典 的 搜索 帮助 ， 例 如 ， 如 果 要 根据 Web Dynpro 应 用 程序 中 输入 
的 值 的 计算 结果 进行 搜索 ， 用 搜索 玫 助 不 能 实现 需求 ， 则 可 以 使 用 对 象 值 选择 (Object Value 
Selection? 输入 帮助 ， 即 OVS 值 帮助 。 

这 两 种 预 实 现 类 型 的 输入 帮助 具有 的 优点 是 可 以 在 同一 时 间 和 输入 几 个 字段 进行 搜索 。 

此 外 ， 程 序 员 也 可 以 编写 目 己 的 输入 帮助 。 程 序 员 也 可 以 利用 选择 标准 的 选择 选项 
(Select Options.)， 为 输入 帮助 添加 更 多 的 限制 。 

程序 员 也 可 以 使 用 一 个 下 拉 列 表 ， 即 UI 元 素 DropDownByIndex 或 UI 元 素 DropDown 
ByKey. 4H] fi Hx UI 元 素 ， 则 应 该 保持 设 定 的 值 的 范围 相对 较 小 。 


ik: 太 多 的 下 拉 式 列表 框 在 一 个 视图 中 ， 可 能 会 导致 性 能 瓶颈 问题 。 


TE Web Dynpro ABAP 应 用 程序 中 , 用 户 可 以 从 ABAP 字典 中 重复 使 用 现 有 的 搜索 帮助 。 
不 过 ， 也 有 数据 类 型 系统 中 没有 提供 搜索 帮助 。 例 如 ，TIMS 数据 类 型 或 工 ( 时 间 ) 没有 F4 


ER 助 
BE] ° 

应 用 程序 可 以 通过 查询 类 CL. WEB DYNRPO 的 属性 的 is_active， 找 出 它 是 否 正 在 Web 
Dynpro 环境 中 运行 。 

语法 : 


IF CL WEB DYNPRO=>IS ACTIVE = ABAP TRUE. 


在 视图 中 可 以 创建 输入 的 字段 的 帮助 CFA. 帮助 )， 这 使 得 它 更 容易 为 用 户 输 入 数据 。 
InputField 元 素 结束 时 的 上 传 提示 符号 意味 着 搜索 帮助 可 用 。 

注 : 搜索 帮助 符号 始终 是 相同 的 ,无 论 是 来 自 ABAP 字典 的 搜索 帮助 ， 还 是 OVS 搜索 带 
助 ， 或 应 用 程序 中 自 定 义 的 搜索 帮助 ， 如 图 7-44 所 示 。 


示例 : 
(2) 特点 
有 以 下 两 种 类 型 的 搜索 帮助 : 
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e 基本 搜索 帮助 。 
e 复合 搜索 帮助 。 


Airline Code 


General value List 


Airline: c: MEN zm. re 


Restrict Number af walue List Entries To 


7-44 


注 : 程序 员 编 辑 搜索 帮助 : 为 了 确保 最 佳 的 用 户 指 导 ， 程 序 员 可 以 通过 在 搜索 帮助 增强 
中 修改 搜索 帮助 弹出 时 间 点 休止 关闭 弹出 值 帮助 。 一 个 打开 的 对 话 框 中 ， 只 能 由 用 户 通 过 久 
下 行动 关闭 。 

@ 从 值 列表 中 选择 一 个 值 

e 触发 “取消 ”按钮 或 | 


用 户 期 望 相关 的 值 列 表 ， 即 使 它 是 空 的 ， 也 不 希望 帮助 对 话 框 被 关闭 。 

(3) 日 期 字段 的 值 帮助 

标准 值 的 一 周 的 第 一 天 是 星期 一 。 用 户 可 以 BADI CCALENDAR DEFINITION) 定义 不 
同 的 一 天 ， 由 此 显示 一 周 的 天 数 和 周 数 变 化 计算 : 

日 期 宇 段 的 值 帮助 〈 功 能 模块 F4_DATE 的 功能 组 SHLC) 调用 以 上 的 BADI. 在 F4 的 帮 
助 中 ， 一 周 的 第 一 天 是 从 BADI 实施 改变 后 其 中 一 周 中 的 一 天 。 如 果 周 数 偏 离 ISO 规则 ， 则 
4 帮助 隐藏 这 一 点 ， 因 为 所 使 用 的 前 端 控制 是 不 正常 的 周 数 。 

(4) 集成 

ABAP 字典 搜索 帮助 通过 Context 属性 的 Value Help Mode 属性 集成 到 Web Dynpro 应 用 
程序 中 。 
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AXE: Context 节点 必须 参照 一 个 字典 结构 定义 。 这 确保 了 结构 的 所 有 部 件 可 在 运行 时 作为 
该 节点 的 动态 属性 。 


只 有 选项 为 Automatic 和 Dictionary Search Help 与 ABAP 字典 搜索 帮助 相关 联 。 

1) Automatic。 搜 索 帮 助 被 分 配 到 参照 ABAP 数据 字典 的 Context 属性 的 数据 类 型 。 
示例 : 

ABAP 数据 字典 定义 ， 如 图 7-45 所 示 。 


数据 元 素 ZZNUMBER E ES 
短文 本 学 生 学 号 | 


Attributes [ Data Type Further Characteristics 1 Field Label | 


| Search Help 


| 
| Name  EZMCSNANE ju] 
| Parameters ZZNUMBER | 


图 7-45 
Context 属性 定义 ， 如 图 7-46 所 示 。 


[= Change Attribute ; 


Attribute Name (ZZNUNMEER 

Type assignment | Type -| 

Type | ZMNUMBER T-ZZNUMBER | 

Read-only [No -| 

Default Value | 

Input Help Mode | Automatic -| 

Ermittelte Wertehilfe ZZNCSNAME 
— 

Type of Input Help ER 大 Bi | 

lk] 7-46 


如 有 果 没 有 搜索 帮助 用 于 Context 的 属性 类 型 , 束 没 有 搜索 帮助 人 符号 显示 , 也 没有 可 以 执行 
的 搜索 帮助 。 

2) Dictionary Search Help. ABAP 字典 中 的 一 个 搜索 帮助 可 以 分 配 到 Context 属性 。 在 属 
性 Input Help Mode 字段 中 选择 Dictionary Search Help 栏 位 时 ， 程 序 员 可 以 在 其 下 面 的 文本 框 
中 输入 需要 的 搜索 帮助 。 在 ABAP 字典 中 ， 必 须 事先 定义 搜索 帮助 。 如 末 不 输入 搜索 帮助 ， 
则 在 运行 时 ， 系 统 会 尝试 使 用 Context 属性 的 类 型 确定 的 搜索 帮助 。 

不 例 : 

Context 属性 定义 ， 如 图 7-47 Bron. 
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[=> Create Attribute X 


Attribute Name TEXTID 
Type assignment | Type - 
Type STRING 
Read-only | No - 
Default Value 
Input Help Mode | Dictionary Search Help - 
Dictionary-Suchhilfe ZZNCSBID 
图 7-47 


E: 搜索 帮助 的 输入 和 输出 参数 必须 在 节点 同一 范围 内 确定 。 


(5) 约束 

e 复合 搜索 帮助 不 文 持 热 键 。 

@ 搜索 帮助 增强 含有 DYNPRO 特定 的 功能 ， 如 CALL SCREEN 不 文 持 。 
e 元 素 TIMS 没有 上 自动 的 F4 帮助 。 

€ Web Dynpro ABAP 的 日 期 值 帮助 不 文 持 所 有 ABAP 日 期 格式 。 


7.4.1 OVS 输入 帮助 


FA 输入 帮助 的 方法 之 一 是 OVS 值 帮 助 〈 对 象 值 选择 Object Value Selection). OVS 值 帮 
助 是 在 系统 端的 Web Dynpro 组 件 中 实现 的 。 

当 OVS 值 帮助 已 定义 一 个 Context 属性 后 , 它 在 绑 定 到 这 个 属性 的 所 有 输入 框 时 是 可 用 
的 。 在 运行 时 ， 当 用 户 按 下 《F4〉 刍 或 单 击 值 帮助 图 标 时 ，OYVS 组 件 上 自动 实例 化 。 同 时 ， 访 
对 话 框 会 自动 创建 在 屏幕 上 。 

1. 系统 组 件 WDR OVS 

在 视图 上 组 件 WDR_OVS 提供 了 搜索 结果 可 以 被 显示 为 一 个 表 的 功能 。 该 组 件 还 包含 一 
个 选择 视图 ， 可 以 用 来 限制 搜索 条 件 。 

视图 中 的 输入 字段 以 及 要 显示 的 表 的 结构 和 内 容 都 要 在 应 用 程序 中 定义 。OVS 组 件 因此 
在 一 个 合适 的 时 间 需 要 使 用 组 件 的 回调 。 

2. 事件 OVS 及 参数 OVS CALLBACK OBJECT 

在 OVS 组 件 的 接口 控制 器 中 使 用 组 件 的 回调 函数 通过 OVS 事件 实现 。 该 事件 一 前 一 后 
被 自动 触发 4 次 。 它 传递 类 型 为 正 WD OVS 的 参数 OVS_CALLBACK OBJECT 到 相应 应 用 
程序 组 件 的 事件 处 理 程序 中 。 事 件 参 数 实 例 属性 PHASE INDICATOR 确定 触发 阶段 。 第 一 次 
触发 该 事件 时 的 属性 值 为 CO_PHASE 0, 当 它 被 触及 第 二 次 时 值 为 CO_PHASE 1. 以 此 类 推 。 
下 面 详细 摘 述 4 个 时 间 点 ， 如 图 7-48 所 示 。 
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my application 
component 


图 7-48 


(1) PHASE INDICATOR - IF WD OVS => CO PHASE 0 

此 时 ， 可 以 配置 OVS 组 件 。 例 如 ， 窗 体 标题 、 搜 索 帮 助 列表 标题 ， 可 以 定义 输出 表 的 列 
标题 。 此 外 ， 还 可 以 设置 在 事件 表 中 是 人 否 应 选择 一 行 或 多 个 行 。 为 实现 这 一 目的 ， 事 件 参 数 
OVS CALLBACK OBJECT 提供 了 方法 SET CONFIGURATION， 它 可 以 在 单独 的 时 间 点 上 
使 用 ， 也 可 以 在 以 后 的 某 个 时 间 点 上 调用 此 方法 触发 一 个 错误 消息 。 

该 阶段 又 称 为 配置 阶段 。 此 处 ， 用 户 可 以 定义 OVS 组 件 在 选择 屏 攻 对 话 框 或 输入 帮助 
列表 中 显示 的 文本 ， 还 可 以 定义 组 成 选择 对 话 框 的 列 的 数量 。 要 将 信息 导出 至 OVS 组 件 ， 
需 调 用 回调 对 象 的 方法 set_configuration()。 


注 : 如 果 OVS 组 件 不 显示 选择 对 话 框 ， 则 可 以 忽略 阶段 0 的 调用 方法 
set configuration( ). 
如 果 据 此 输入 相关 输入 字段 ， 则 无 法 从 ABAP 字典 获取 用 户 组 件 不 提供 的 标签 文本 。 


(2) PHASE INDICATOR =IF WD OVS => CO PHASE 1 

用 户 可 以 定义 选择 对 话 框 中 要 显示 的 输入 学 段 。 可 通过 导出 包 侣 这些 字 段 的 任意 结构 来 
完成 该 操作 。 通 过 将 结构 宇 段 设置 为 相应 值 ， 可 指定 选择 字段 的 默认 值 。 

要 将 信息 守 出 全 OVS 组 件 ， 需 调用 回调 对 象 的 方法 set input structure0， 然 后 可 呈现 
X TE BEAR o 

注 : 可 以 忽略 阶段 1 的 调用 方法 set input structure( )。 这 种 情况 下 ， 将 不 显示 选择 屏幕 


( 直接 显示 列表 对 象 )。 如 果 用 户 已 经 在 用 户 组 件 的 输入 字段 中 输入 了 值 ， 则 在 显示 输入 帮助 
之 前 ， 不 需要 再 次 在 OVS 选择 对 话 框 上 显示 相同 的 值 。 


(3) PHASE INDICATOR =IF WD OVS — CO PHASE 2 

在 此 阶段 ， 在 用 户 按 下 OVS 选择 对 话 框 〈 如 末 已 处 理 ) 的 按钮 后 ， 将 开始 处 理 访 阶段。 在 
此 阶段 ， 用 户 必 须 收集 OVS 组 件 稍 后 将 显示 为 输入 帮助 列表 的 数据 。 然 而 ， 要 收集 这 些 信息 ， 
用 户 组 件 需要 了 解 用 户 已 经 在 选择 对 话 框 的 字段 中 输入 的 内 容 。 回 调 对 象 的 query parameters 
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参数 可 提供 此 信息 的 引用 数据 引用 )。 

要 将 值 列 表 导 出 至 OVS 组 件 ， 需 调用 回调 对 象 的 方法 set_output_table( )， 随 后 显示 该 值 
列表 。 

(4) PHASE INDICATOR - IF WD OVS — CO PHASE 3 

在 选择 值 列 表 的 值 后 ， 必 须 将 该 选择 传输 回 用 户 组 件 。 因 此 ， 需 要 第 四 次 触发 OVS 事 
件 。 数 据 引 用 变量 selection 是 回调 对 象 OVS CALLBACK OBJECT 的 参数 ， 可 提供 用 户 选 
择 的 引用 。 在 用 户 组 件 事件 处 理 器 方法 SET CONFIGURATION 的 相关 编码 段 中 ， 必 须 将 这 
些 值 写 回 至 Context。 选 定数 据 显 示 为 用 户 组 件 视图 的 输入 字段 值 。 


Hs OVS 具有 4 个 阶段 ， 且 每 个 阶段 只 调用 一 次 。 
可 使 用 下 列 属 性 识别 不 同 的 阶段 : OVS CALLBACK OBJECT> PHASE INDICATOR, 


3. 绑 定 值 到 一 个 Context 属性 

要 绑 定 一 个 OVS 帮助 的 值 到 Context 属性 ， 需 执行 以 下 步骤 : 

1) 组 件 WDR OVS 的 组 件 用 法 必须 由 用 户 组 件 声明 。 

2) OVS 界面 控制 占 的 用 法 必须 在 用 户 组 件 的 控制 占 中 声明 ， 如 组 件 控制 器 或 显示 视图 
Talde o 

3) JU TBI Js TH JE AN 18 IAS TREAT 2 H Pes (Object Value Selection). 

4) 必须 创建 并 实施 OVS 组 件 用 法 的 事件 OVS 处 理 器 方法 。 

4. OVS 值 帮 助 Context 更 改 日 志 

当 用 户 使 用 OVS 值 帮助 时 ， 仍 然 可 以 使 用 OVS 值 帮 助 Context 更 改 日 志 的 功能 。 


注 : 在 阶段 PHASE INDICATOR IF WD OVS => CO PHASE 3 中 ， 所 选择 的 数据 必须 
显 式 输入 更 改 日 志 的 表 中 ， 所 以 这 仅 在 需要 的 地 方 会 自动 为 用 户 输入 。 


7.4.2” 自 定义 输入 帮助 


除了 上 述 输 入 帮助 拉 术 外 ， 程 序 开发 员 还 可 定义 一 个 完全 由 用 户 定义 的 输入 帮助 。 从 技 
术 上 讲 , 该 类 输入 帮助 可 作为 实施 Web Dynpro 组 件 界 面 IVWD VALUE HELP 的 Web Dynpro 
组 件 来 实施 。 一 旦 用 户 目 定义 的 输入 帮助 链接 到 Context 属性 ， 则 视图 中 任何 绑 定 Context 属 
性 的 输入 框 的 输入 帮助 会 变 得 可 用 。 

(1) 链接 到 Context 属性 

要 使 用 某 个 输入 字段 的 输入 帮助 ， 需 要 执行 下 列 步 又 : 

1) 输入 帮助 组 件 的 组 件 用 法 必须 由 用 户 组 件 声明 。 

2) 输入 帮助 组 件 的 界面 控制 右 的 用 法 必须 在 用 户 组 件 视图 中 声明 。 

3) 必须 为 相关 的 属性 选择 输入 帮助 模式 用 户 定义 的 编程 。 

(2) 接口 IWD VALUE HELP 

输入 帮助 组 件 的 组 件 接口 有 一 个 方法 : set value help listener()。 如 果 单 击 相 关 输 入 字段 
的 输入 帮助 按钮 ， 则 Web Dynpro 运行 时 环境 会 调用 该 方法 。 

必须 按 下 列 步 又 实施 输入 帮助 组 件 : 

€ 方法 set value help listener( ) 有 一 个 导入 参数 。 这 意味 大 WebDynpro 运行 时 ， 环 境 
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所 提供 的 收听 器 引用 将 传输 到 用 户 定 义 的 输入 帮助 组 件 。 帮 助 组 件 可 以 使 用 该 接口 告 
诉 框 架 窗 体 被 关闭。 例如 ， 如 果 数 据 已 被 选 择 ， 或 者 取消 已 被 授 下 ， 或 者 友 生 了 一 个 
错误 。 该 接口 包含 两 个 属性 F4 CONTEXT ELEMENT 和 F4 ATTRIBUTE INFO. 它 
们 描述 的 FA 帮助 已 请 求 Context 元 素 。 必 须 将 该 引用 保存 为 用 户 定 义 的 控制 堪 属 性 。 

e 事件 VH WINDOW CLOSED 和 VH WINDOW OPENED 会 触发 Web Dynpro 框架 。 
这 些 事 件 表 明 的 时 间 点 为 输入 帮助 窗 体 的 关闭 或 打开 。 在 组 件 接口 IWD VALUE _ 
HELP 实施 时 ， 这 些 事件 被 复制 到 值 帮助 组 件 中 ， 这 使 它们 可 以 调用 组 件 ， 并 允许 其 
注册 这 些 事件 的 事件 处 理 程序 到 组 件 接口 。 要 关闭 帮助 值 对 话 框 ， 必 须 使 用 收听 器 的 
close window( ) 方法 。 

e JAUEPURTRUEHRUNA 7 WD VALUE HELP 的 窗 体 中 。Web Dynpro 运行 时 环境 会 
使 用 该 名 称 。 

€ Context 映射 可 用 于 在 输入 帮助 组 件 和 用 户 组 件 之 间 交 换 数 据 。 


注 : 要 实施 组 件 接 口 IWD VALUE HELP， 需 要 选择 输入 帮助 组 件 中 的 重新 实施 按钮 . 
实施 状态 变 为 绿色 ， 并 且 输 入 帮助 组 件 HC 控制 器 中 会 显示 组 件 界面 的 事件 和 方法 。 

(3) 目 定 义 输入 帮助 Context 更 改 日 志 

当 用 户 使 用 目 定 义 输入 帮助 时 ,仍然 可 以 使 用 Context 更 改 日 志 的 功能 。 但 是 ， 由 用 户 选 
择 的 值 不 会 日 动 写 入 更 改 表 ， 需 要 编程 明确 。 
743 ”选择 标准 


组 件 WDR SELECT OPTIONS 作为 一 个 选项 屏幕 的 可 重用 的 组 件 ， 尤 其 是 当 使 用 输入 
范围 作为 输入 帮助 时 。 接 口 [F WD SELECT OPTIONS 提供 用 于 此 目的 处 理 程序 。 


注 : 参照 经 典 SAP GUI 的 选择 屏幕 的 选择 选项 ，Web Dynpro ABAP 通常 会 提供 相同 的 功 
。 需 要 注意 的 是 ，Web Dynpro ABAP + i 4E HECIE RE. 


zm 
CC 


要 使 用 选择 选项 部 分 人 能 入 WDR SELECT OPTIONS 组 件 到 自己 的 组 件 。 


iz: 要 创建 一 个 组 件 的 使 用 ， 而 不 是 诅 入 在 选择 选项 组 件 本 身 的 窗口 中 。 


4 个 标准 按钮 提供 以 下 功能 。 

1) 取消 设置 (Cancel): 终止 处 理 。 系 统 返 回 到 应 用 程序 中 的 最 后 一 个 显示 的 画面 。 

2) M (Reset): 由 用 户 输 入 的 所 有 选择 字段 的 内 容 倍 清除 。 接 口 扣 供 方法 RESET. 
SELECTION_FIELD《〈 复 位 某 一 个 选择 字段 的 范围 表 ) 和 RESET_ ALL SELCTIONS FIELDS 
《复位 所 有 选择 字段 的 范围 表 ) 用 于 此 。 

3) 完成 (Done): 确定 用 户 输 入 并 使 用 输入 的 数据 继续 处 理 。 

4) JJA (Check): 由 用 户 输 入 的 数据 进行 验证 检查 。 接 口 方法 CHECK ALL SELECTION 
FIELDS“〈 检 租 ， 所 有 的 选择 信息 的 输入 是 正确 的 ) 设置 在 接口 上 。 

对 于 取消 和 复制 两 个 功能 ， 用 户 只 有 在 WDR SELECT OPTIONS 组 件 中 注册 事件 ， 才 
能 实现 取消 和 复制 功能 。 

当 用 户 单 击 其 中 一 个 按钮 时 ， 该 事件 被 触发 。 注 意 ， 只 有 在 自由 定义 输入 帮助 和 ABAP 
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字典 输入 帮助 的 选择 选项 〈Select Options). 是 有 效 的 ， 但 不 支持 OVS 帮助 。 
使 用 SET GLOBAL OPTIONS 方法 可 以 隐藏 这 些 按钮 中 的 一 个 或 全 部 , 并 可 以 指定 哪些 
标准 按钮 不 想 设 置 。 由 于 单独 的 功能 ， 用 户 还 可 以 定义 目 己 的 按钮 。 
一 旦 需要 停 用 标准 按钮 ， 则 程序 员 可 以 调用 组 件 接口 或 辅助 类 的 相应 方法 ， 在 源 代码 中 


触发 的 动作 。 
方法 ADD SELECTION FIELD 可 以 为 字段 增加 查询 条 件 。 


注 ，Web Dynpro ABAP 的 选择 选项 组 件 还 支持 dynpro 环境 中 的 参数 字段 。 


组 件 程序 WDR TEST SELECT OPTIONS 的 运行 结果 如 图 7-49 所 示 。 


CEZIECIHIE E 
tuazB: @ | 13 | |> 
组 标题 
ELLII ° | 至 |o 
| 水 平装 订 线 之 后 的 字符 串 : O | 至 » 


| Sometext that is within a group. This text is really long to show that the feature works as desired. Let's add some pangrams to create some even longer text. The quick brown fox jumps over a 
lazy dog. Whenever the black fox jumped the squirrel gazed suspiciously. Crazy Fredericka bought many very exquisite opal jewels. The text should wrap to the next line. 


盘 标题 [7] 
盘 中 的 字符 串 : O | 至 


o 


透明 容器 中 的 字符 时 : 仿 | | 至 


块 元 素 外 部 水 平装 订 线 之 后 的 短文 本 。 用 该 文本 说 明 功 能 按照 设计 的 那样 工作 显得 太 长 。 Let's add some pangrams to create some even longer text. The quick brown fox jumps over a lazy dog. 
Whenever the black fox jumped the squirrel gazed suspiciously. Crazy Fredericka bought many very exquisite opal jewels. The text should wrap to the next line. 

块 元 素 外 部 水 平装 订 线 之 后 的 夭 文 本 。 用 该 文本 说 明 功 能 按 申 设 计 的 那样 工作 显得 术 长 。 Let's add some pangrams to create some even longer text. The quick brown fox jumps over a 
lazy dog. Whenever the black fox jumped the squirrel gazed suspiciously. Crazy Fredericka bought many very exquisite opal jewels. The text should wrap to the next line. 


Result 

Triggered Events 

"Cancel": 0 "Reset": 0| "Enter Button": 0 
"Check": 0 "Apply": 0 


图 7-49 


74.4 ”编辑 Web Dynpro M HfZT 


1. 自 定义 检索 帮助 应 用 程序 
1) 在 ABAP 工作 台中 的 Web Dynpro 组 件 编辑 界面 创建 Web Dynpro 组 件 。 
选中 “Web Dynpro Comp./Int£.", 在 相应 的 文本 框 中 输入 程序 的 名 称 ， 如 图 7-50 所 示 。 


创建 Web Dynpro 组 件 ， 如 图 7-51 所 示 。 


[c Web Dynpro: Component / Create Interface 


Name ZWD STUDENT HELP 
Description SEHE Bh 
Type (€) Web Dynpro Component 


(Web Dynpro Component Interface 


Window Name — |W STUDENT HELP 


Web Dynpro Comp. / Intf. * View Name V MAIN 


[ZWD. STUDENT. HELP RAF" | iv] 


图 7-50 图 7-51 
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编辑 Web Dynpro 组 件 ， 如 图 7-52 所 示 。 


Object Name | Description 


- «f COMPONENTCONTROLLER 学 生 检 索 帮 助 --- 组 件 控 制 | 器 

Y dð Component Interface 

. 26 INTERFACECONTROLLER 学生 检索 帮助 --- 组 件 控 制 器 

~ IE Interface Views 

- Él W_STUDENT_HELP | 学 生 检索 帮助 一 窗 体 

> Views | 

- Ej v MAIN 学 生 检 索 帮 助 -一 视图 
STIDNNMANNE COTES s 
° D1w STUDENT HELP | 学 生 检索 帮助 一 窗 体 _ 


7-52 


2) 在 ABAP 工作 台中 的 组 件 编辑 界面 添加 组 件 接口 。 
删除 窗 体 W_STUDENT_HELP， 实 施 组 件 接 口 IWD VALUE HELP， 如 图 7-53 所 示 。 


Web Dynpro Component IZWD STUDENT. HELP  |Inactive/revised 
Description 学 生 检 索 帮 助 
Assistance Class m 
Created By BCUSER Created On 2011/10/24 
Last Changed By BCUSER Changed On 2011/10/24 

s "ZH 
Original Lang. HD Package ZWD_TRAINING 
[V] Accessibility Checks Active 


Used Components — Implemented interfaces | 


Name Description Implement... Action 
IWD_VALUE_HELP coa 


7-53 


3) Æ ABAP 工作 台中 的 组 件 编辑 界面 编辑 组 件 控制 器 。 
选择 组 件 控制 器 COMPONENTCONTROLLER， 选 择 “Context” 选 项 卡 ， 创 建 Context, 
节点 NODE LIST， 如 图 7-54 所 示 。 


LE Change Node 


Node Name NODE LIST 
Interface Node No - 
Input Element (Ext.) No v 


Dictionary structure 


Cardinality fon | "| 

Selection (0.1 | v| 

Init. Lead Selection Yes v 

Singleton No v 

Supply Function DATA SELECT | 

Mapping Path n ————MMMMA«4«4«4«4«444«««4«—«—-—- 01] 


[v] Aaa Attribute from structure JB] 
7-54 
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节点 NODE SELECTED， 如 图 7-55 所 示 。 


[=> Create Node 


Mode Name NODR SELECTED 


Interface Node — 
Input Element (Ext.) 


Dictionary structure 


Cardinality 
Selection 

Init. Lead Selection 
Singleton 

Supply Function 


7-55 
SN EN 
编辑 结果 如 图 7-56 所 示 。 
Component Controller m ICOMPONENTCONTROLLER | Inactive(revised) 
^ Properties 4 Events 
Context COMPONENTCONTROLLER | 
~ (Ó CONTEXT 
v [5] NODE LIST 
* “b ZZNUMBER 
* b ZZNAME 
v [6] (B) NODE SELECTED 
* $ ZZNUMBER 
* "B ZZNAME 
71-56 


选择 “Attributes” 选 项 卡 ， 添 加 属性 如 网 7-57 所 示 。 


Component Controller 'COMPONENTCONTROLLER | Inactive(revised) 
. Properties ; Context 4 


Public RefTo ， 参考 打印 Description | 
WD CONTEXT o IF WD CONTEXT NODE Reference to Local Controller C 
WD THIS 口 IF COMPONENTCONTROLLER Self-Reference to Local Control 
VALUE HELP LISTENER [v] IF WD VALUE HELP LISTENER 鉴 视 器 
[] [] 
T-S 


选择 “Events” 选 项 卡 ， 添 加 事件 如 网 7-58 所 示 。 
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Component Controller COMPONENTCONTROLLER Inactive 
Properties ^ Context | Attributes Events |“ Methods 


Event Interface | Description 


— NH WINDOW CLO SED [v| 
VH WINDOW OPENED [v 


"H DATÀ SELECTED 


v) ”数据 选择 事件 


图 7-58 


选择 “Methods” 迁 项 卡 ， 编 辑 上 基体 方 法 如 图 7-59 Dra. 


Component Controller COMPONENTCONTROLLER Inactive 
Properties Context Attributes Events 


ga =} a o | (iR ia 
Method Method Type Interface Description Event Controller] 
SET VALUE HELP LIST.Method ~v i 
WDDOAPPLICATIONSTAT.Method v 国 
WDDOBEFORENAVIGATION Method v m Error Handling Before Navigation Through Applicati... 
WDDOEXIT Method v m Cleanup Method of Controller 
WDDOINIT Method v gi Initialization Method of Controller 
- WDDOPOSTPROCESSING Method ~o (] Handing During the Context Validation of Errors O.. 
DATA SELECT Supply .. v |] BRAR 
Method v is 
图 7-59 


方法 SET VALUE HELP. LISTENER 编辑 如 下 : 


METHOD SET VALUE HELP LISTENER . 


WD THIS-2VALUE HELP LISTENER = LISTENER. 


ENDMETHOD. 


供给 函数 编辑 如 下 : 


METHOD DATA SELECT. 


* General Notes 


* 4 common scenario for a supply method is to aquire key 
* informations from the parameter «parent element? and then 
* to invoke a data provider. 


* 4 free navigation thru the context, especially to nodes on 


* the same or deeper hierachical level is strongly discouraged, 


* because such a strategy may easily lead to unresolvable 
* situations!! 

* jf necessary, get static attributes of parent element 

* DATA [Is parent attributes TYPE wd this->element context. 
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* parent element-^get static attributes( 
i IMPORTING 


Í static attributes = [s parent attributes ). 


* 


* data declaration 
DATA LT NODE LIST TYPE WD THIS--ELEMENTS NODE LIST. 
DATA LS NODE LIST LIKE LINE OF LT NODE LIST. 
* (I ODO compute values 
SELECT ZZNUMBER 
ZZNAME 
FROM ZMNUMBER TINTO TABLE LT NODE LIST. 


* bind all the elements 
NODE->BIND TABLE( 
NEW ITEMS — LT NODE LIST 
SET INITIAL ELEMENTS = ABAP TRUE ). 


ENDMETHOD. 


4) 在 ABAP 工作 台中 的 视图 编辑 界面 编辑 视图 。 
选择 视图 VY MAIN, tj “Context” mR, IIE Context 如 图 7-60 所 示 。 


View V MAIN Inactive(revised) 
Properties V Layout Inbound Plugs Outbound Plugs Attributes Actions Methods 


口 Controler usage | 


Context V MAIN < 
~ © CONTEXT Context COMPONENTCONTROLLER 


Y [S] NODE LIST Y (O CONTEXT 
° ia inani v [5] NODE LIST 
. * "t3 ZZNUMBER 
X NODE_SELECTED * $ ZZNAME 
* $ ZZNUMBER v [$] (B) NODE SELECTED 
* "b ZZNAME | * $ ZZNUMBER 
; * “b ZZNAME 
图 7-60 


F% “Layout” WMF, BJ ULER, WME 7-61 rz. 


* [|] CONTEXT. MENUS 
~ []ROOTUIELEMENTCONT AINER 
Y ËJ GRP. LIST 
* T CAPTION [Header] 
- OTe usr 
v [H TBL LIST. ZZNUMBER 
* EE] TEL. LIST. ZZNUMBER. EDITOR 
* T TEL LIST ZZNUMBER HEADER [Header] 
~ [E TEL LIST. ZZNAME 
- EE TBL LIST. ZZNAME. EDITOR 
* T TBL LIST ZZNAME HEADER [Header] 
* T CAPTION 1 [Header] 


图 7-61 
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K UI 元素 TBL LIST 的 onLeadSelect 属性 添加 动作 DATA SELECT, "n 7-62 所 示 。 


[ŒE Create Action x 


Component ZWD STUDENT HELP 
View V MAIN 

Action DATA SELECT 
Description 选择 数据 


 ] Transfer UI Event Parameters 


ET] 
图 7-62 
编辑 结果 如 图 7-63 所 示 。 
学 生 信息 
学 生 信息 一 览 
学 生 学 号 姓名 
行 | 1| 的 5 
图 7-63 


选择 “Actions” 选 项 卡 ， 编 辑 动作 DATA SELECT 的 处 理 程序 如 下 : 


METHOD ONACTIONDATA SELECT. 

* ”取得 选择 数据 

DATA LO ND NODE LIST TYPE REF TOIF WD CONTEXT NODE. 

DATA LO EL NODE LIST TYPE REF TOIF WD CONTEXT ELEMENT. 

DATA LS NODE LIST TYPE WD THIS--ELEMENT NODE LIST. 
navigate from «CONTEXT» to «NODE LIST> via lead selection 


LO ND NODE LIST = WD CONTEXT-GET CHILD NODE( NAME 
WD THIS-WDCTX NODE LIST). 


* 


* 


get element via lead selection 


LO EL NODE LIST - LO ND NODE LIST->GET ELEMENT( ). 


* get all declared attributes 


LO EL NODE LIST->GET STATIC ATTRIBUTES( 
IMPORTING 


STATIC ATTRIBUTES = LS NODE LIST ). 
* 回 外 界 传 值 
DATA LO ND NODE SELECTED TYPE REF TOIF WD CONTEXT NODE. 
DATA LO EL NODE SELECTED TYPE REF TO IF WD CONTEXT ELEMENT. 
DATA LS NODE SELECTED TYPE WD THIS--ELEMENT NODE SELECTED. 
* navigate from «CONTEXT» to «NODE SELECTED? via lead selection 


LO ND NODE SELECTED = WD CONTEXT-GET CHILD NODE( NAME = 
WD THIS-WDCTX NODE SELECTED). 


* get element via lead selection 
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LO EL NODE SELECTED - LO ND NODE SELECTED--GET ELEMENTY( ). 
* (TODO fill static attributes 
MOVE-CORRESPONDING LS NODE LIST TOLS NODE SELECTED. 


* set all declared attributes 
LO EL NODE SELECTED->SET STATIC ATTRIBUTES( 


STATIC ATTRIBUTES - LS NODE SELECTED). 
* 触发 事件 
WD COMP _ CONTROLLER->FIRE VH DATA SELECTED EVT( 
). 
WD COMP CONTROLLER->VALUE HELP LISTENER->CLOSE WINDOW( ). 
ENDMETHOD. 


5) 在 ABAP 工作 台中 的 窗 体 编辑 界面 编辑 窗 体 。 
选择 窗 体 WD VALUE HELP， 将 视图 V_MAIN 藤 入 窗 体 编辑 如 图 7-64 所 示 。 


WD VALUE HELP Active(revised) 
^ Inbound Plugs Y Outbound Plugs Y Context V Attributes V Methods | 


Window-Struktur Description 
M I WD VALUE HELP E 
* 国 v MAIN 学 生 检 索 和 帮助 一 视图 
， DEFAULT | 
图 7-64 


2. 检索 帮助 应 用 主 程序 
1) 启动 ABAP 工作 台 ， 在 Web Dynpro 组 件 编辑 界面 创建 Web Dynpro 组 件 。 
选中 “Web Dynpro Comp./Intf.” 在 相应 的 文本 框 中 输入 程序 的 名 称 ， 如 图 7-65 所 示 。 


Web Dynpro Comp. / Intf. = 
WD INPUT HELP RAF" 


图 7-65 


创建 Web Dynpro 组 件 如 图 7-66 PZR. 


LE Web Dynpro: Component / Create Interface 


Name ZWD INPUT HELP 
Description LES 
Type (e Web Dynpro Component 


DWeb Dynpro Component Interface 


Window Name | W HRLP 


View Name v MAIN 


图 7-66 
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编辑 Web Dynpro 组 件 如 图 7-67 所 示 。 


Object Name Description 
~ dà ZWD INPUT HELP 学 生 检索 
- 4 COMPONENTCONTROLLER | 学 生 检 索 一 组 件 控 制 器 
* dj Component Interface 
- ch INTERFACECONTROLLEFR RŽ Età —$2B P Tz sla 
= FE Interface Views 


* [E] w HELP PEt E 
* E Views 
.- P] v MAIN 学 生 检索 一 视图 
- [E windows 
"H 
7-67 


2) 在 ABAP 工作 台中 的 Web Dynpro 组 件 编辑 界面 添加 使 用 组 件 。 
选择 组 件 ， 选 择 “Used Components” 选 项 卡 ， 添 加 使 用 组 件 ， 如 图 7-68 Hrs. 


Web Dynpro Component ZWD INPUT. HELP Active/revised 
Description 学生 检索 

Assistance Class | | 

Created By BCUSER Created On 2011/10/24 
Last Changed By BCUSER Changed On 2011/10/24 
Original Lang. [ZH Package ZWD TRAINING 


[V] Accessibility Checks Active 


Implemented interfaces 


=. = 
Used Web Dynpro Components 
Component Use (Component Description of Component 
STUDENT. OVS WDR OVS 
ETUDENT HELP WD. STUDENT. HELP 学 生 检 索 帮 助 


7-68 
3) 在 ABAP TH 6 mma fep ds a 4 TRU 2 4H ZH TET S o 
选择 组 件 控制 器 COMPONENTCONTROLLER， 选 择 “Properties” 选 项 卡 ， 添 加 使 用 组 
件 ， 如 图 7-69 所 示 。 


Component Controller COMPONENTCONTROLLER |Inactive(revised) 

dA Properties | Context | Attrbutes | Events | Methods - 

Description 党 生 检 索 一 组 件 控制 器 | 
创建 者 BCUSER 创建 日 期 2011/10/24 

TR eo A. BCUSER 更 改 日 期 2011/10/24 


Component Use Component Controller Description 

STUDENT. HELP ZWD STUDENT HELP l FERRER 

STUDENT_HELP ZWD STUDENT HELP INTERFACECONTROLLER 学生 检 索 帮助 -- 蛤 件 控制 器 
7—69 
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选择 “Context” 选 项 卡 ， 创 建 Context， 如 图 7-70 所 示 。 
ÍCONPONENTCONTROLLER | Inactve(revised) 


Component Controller 


Context COMPONENTCONTROLLER 


~ (O CONTEXT 


* $ ZZNAME 


* b ZZNAME 


Y [$] NODE INPUT HELP 
* $ ZZNUMBER AUTO 
* $ ZZNUMBER SECH 
* $ ZZNUMBER OVS 
* D ZZNUMBER FREE 


* "i3 ZZNUMBER 


7-70 


NODE SELECTED 的 节点 NODE INPUT HELP， 如 网 7-71 所 示 。 


[c Create Node 
(NODE INPUT HELP | 


Node Name 


Interface Node [No - 

Input Element (Ext.) No d 

Dictionary structure | | 
Cardinality | 1..1 ”| 

Selection [0..1 | 

Init. Lead Selection Yes v 

Singleton No v 

Supply Function | | 


(YY Add Attribute from Structure jw Additional Node J[X] 


7-71 


属性 ZZNUMBER AUTO, WK] 7-72 所 示 。 


Attribute Name ZZNUMBER AUTO 

a Eruan, vl 
Type assignment | Type M 
Type ZMNUMBER T-ZZNUMBER 
Read-only - No Y 
Default Value | | 
Input Help Mode Automatic v 
Ermittelte Wertehilfe | | 
Type of Input Help | | 


f 72 
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属性 ZZNUMBER SECH， 如 图 7-73 所 示 。 


[=> Create Attribute 


Attribute Name AZZNUMBER SECH 

Type assignment Type T 

Type STRING 

Read-only [o vl 

Input Hep Mode 
Dictionary-Suchhilfe ZAMCSBID 


7-73 


属性 ZZNUMBER OVS, nl 7-74 所 示 。 


[=> Change Attribute 


Read-only No - 


Default Value 
Input Help Mode Object Value Selector kh. 


OVS-Component-Verwendung STUDENT OVS 
7-74 


属性 ZZNUMBER FREE, WK] 7-75 所 示 。 
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[=> Create Attribute 


上 


Attribute Name LAZNUMBER FREE 


Type assignment "we 7 
Type STRING 
Read-only ho | * 


Default Value 


Input Help Mode Freely Programmed * 


Wertehilfe-Component-Verw SIUDENT HELP 


d= 


E= 


选择 “Methods” 选 项 卡 ， 编 辑 事件 处 理 程序 如 图 7-76 所 示 。 


Component Controller COMPONENTCONTROLLER Active 

Properties | Context V Attributes Events A Methods | 
Eb. | [S6 |n [t8] [| E] Ifi] o | (M || 

Method Method Type Interface Description Event Controller Component Use 
FVH SELECTED Event H. 7 数据 选择 VH DATÀ SELECTED INTERFACECONTROLLER STUDENT. HELP 
WDDOAPPLICATIONSTAT. Method v 
WDDOBEFORENAVIGATION Method Error Handling Before Navi.. 
WDDOEXIT Method Cleanup Method of Contr .. 


Initialization Method of Co... 
Handling During the Cont .. 


WDDOINIT Method 
WDDOPOSTPROCESSING Method 


IPS SUS 


图 7-76 


METHOD FVH SELECTED . 
DATA LO ND NODE SELECTED TYPE REF TO IF WD CONTEXT NODE. 


DATA LO EL NODE SELECTED TYPE REF TO IF WD CONTEXT ELEMENT. 
DATA LS NODE SELECTED TYPE WD THIS--ELEMENT NODE SELECTED. 


* navigate from «CONTEXT» to «NODE SELECTED> via lead selection 

LO ND NODE SELECTED = . WD CONTEXT-»GET CHILD NODE( NAME 

WD THIS-^WDCTX NODE SELECTED). 

* get element via lead selection 

LO EL NODE SELECTED - LO ND NODE SELECTED--GET ELEMENTY( ). 
* get all declared attributes 

LO EL NODE SELECTED->GET STATIC ATTRIBUTES( 

IMPORTING 
STATIC ATTRIBUTES = LS NODE SELECTED). 
DATA LO ND NODE INPUT HELP TYPE REF TOIF WD CONTEXT NODE. 


DATA LO EL NODE INPUT HELP TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LS NODE INPUT HELP TYPE WD THIS--ELEMENT NODE INPUT HELP. 
* navigate from «CONTEXT» to «NODE INPUT HELP via lead selection 
LO ND NODE INPUT HELP = WD CONTEXT--GET CHILD NODE( NAME = 
WD THIS-^WDCTX NODE INPUT HELP). 
* get element via lead selection 
LO EL NODE INPUT HELP - LO ND NODE INPUT HELP->GET ELEMENTN( ). 
* (TODO fill static attributes 
MOVE LS NODE SELECTED-ZZNAME to LS NODE INPUT HELP-ZZNAME. 
MOVE LS NODE SELECTED-ZZNUMBER to LS NODE INPUT HELP-ZZNUMBER FREE. 


* set all declared attributes 
LO EL NODE INPUT HELP-^SET STATIC ATTRIBUTES( 
STATIC ATTRIBUTES = LS NODE INPUT HELP). 


ENDMETHOD. 
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4) ABAP 工作 台中 的 编辑 界面 创建 组 件 ， 使 用 组 件 间 的 Context 映射 。 
选择 组 件 接 口 INTERFACECONTROLLER USAGE， 选 择 “Properties” 选 项 卡 ， 添 加 使 


用 组 件 ， 如 图 7-77 所 示 。 
Controller Usage INTERFACECONTROLLER USAGE Inactive(Revised) 
Component Usage STUDENT HELP | 


Using Component ZWD INPUT HELP 
Used Component ZWD STUDENT, HELP ] 


创建 者 'BCUSER | ARpA [2011/10/24] 
最 后 修改 人 [BCUSER | 更改 日 期 [2011/10/24] 


ents 
(Component [Controler [Description 
ZWD INPUT HELP "'OMPONENTCONTROLLER 学 生 检 索 一 组 件 控制 器 


1-11 
选择 “Properties ”选项 卡 ， 为 组 件 接 口 Context 建立 外 部 映射 ， 如 网 7-78 所 示 。 
Controller Usage |INTERFACECONTROLLER_USAGE | Inactive(Revised) 


Context NTERFACECONTROLLER EREWDCRPULHERFCONPONENCONTOUER | 


7 O CONTEXT Context COMPONENTCONTROLLER 


M ~ (Ó) CONTEXT 
* "b ZZNUMBER » [$) NODE INPUT. HELP 
* B ZZNAME * [3] NODE SELECTED 
* "i ZZNUMBER 
* "3 ZZNAME 


7-78 


5) Æ ABAP 工作 台中 的 视图 编辑 界面 编辑 视图 。 
选择 “Properties” 选 项 卡 ， 为 视 岁 添加 组 件 使 用 如 图 7-79 PTR. 


View V_MAIN | Inactive(revised) 
Description 学 生 检 索 一 视图 EN 
Lifetime framework contro... w 
创建 者 IBCUSER | ARAM [2011/10/24] 
最 后 修改 人 'BCUSER |! 更改 日 期 [2011/10/24] 


(Component ‚Controller Description 
ZWD INPUT HELP "ONPONENTCONTROLLER 学 生 检 索 一 组 件 控制 器 


WDR OVS 
WDR OVS INTERFACECONTROLLER 


7-79 
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VEFE "Properties" mF, HBASIJEGUZ Context, HHE 7-80 所 示 。 


View V MAIN | Active(revised) 
Properties 上 Layout Inbound Plugs Outbound Plugs ^ Attributes | Actions Methods 
~ CONTEXT — Contex COMPONENTCONTROLLER 
bá NODE INPUT HELP - O CONTEXT 


$ ZZNUMBER_AUTO 
* $ ZZNUMBER SECH 
* $ ZZNUMBER OVS 
* $ ZZNUMBER FREE 
* b ZZNAME 


v [5] NODE INPUT. HELP 
* $ ZZNUMBER AUTO 
* $ ZZNUMBER SECH 
* $ ZZNUMBER OVS 
* $ ZZNUMBER FREE 
* $ ZZNAME 

» [5] NODE SELECTED 


图 7-80 
选择 “Methods” 选 项 卡 ， 编 辑 事件 处 理 程序 如 图 7-81 所 示 。 


一 
View V MAIN Inactive(revised) 


^ properties | Layout 


| Bl- | ME 


Method Type |Description Event Controller Component Use 


| WDDOAFTERACTION Method  "* 
|. WDDOBEFOREACTION Method  "* 
| WDDOEXIT Method — * Cleanup Method of Controller 
x WDDOINIT Method * Initialzation Method of Controll... 
^ WDDONODIFYVIEW Method * Method for Modifying the View . 
x WDDOONCONTEXTMENU Method  "* 
| lovs SELECTED Event H. DOWS5 数 据 选 择 OVS INTERFACECONTROLLER STUDENT_OWS 
m Method ~ 
图 7-81 


METHOD OVS SELECTED. 
* declare data structures for the fields to be displayed and 
* for the table columns of the selection list, if necessary 
TYPES: 
BEGIN OF LTY STRU INPUT, 
add fields for the display of your search input here 
ZZNUMBER TYPE ZZNUMBER E, 
ZZNAME TYPE ZZNAME E, 
END OF LTY STRU INPUT. 
TYPES: 
BEGIN OF LTY STRU LIST, 
* add fields for the selection list here 
ZZNUMBER TYPE ZZNUMBER E, 
ZZNAME TYPE ZZNAME E, 
END OF LTY STRU LIST. 


* 


DATA:LS SEARCH INPUT TYPELTY STRU INPUT, 
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LT SELECT LIST TYPE STANDARD TABLE OF LTY STRU LIST, 
LS TEXT TYPE WDR NAME VALUE, 

LT LABEL TEXTS TYPE WDR NAME VALUE LIST, 

LT COLUMN TEXTS TYPE WDR NAME VALUE LIST, 

LV WINDOW TITLE TYPE STRING, 

LV GROUP HEADER TYPE STRING, 

LV TABLE HEADER TYPE STRING. 


FIELD-SYMBOLS: «L8 QUERY PARAMS> TYPE LTY STRU INPUT, 
«LS SELECTION TYPELTY STRU LIST. 


CASE OVS CALLBACK OBJECT->PHASE INDICATOR. 
WHEN IF WD OVS= CO PHASE 0. "configuration phase, may be omitted 


in this phase you have the possibility to define the texts, 
* jf you do not want to use the defaults (DDIC-texts) 


* 


LS TEXT-NAME - ZZNUMBER*'. "must match a field name of search 
LS TEXT-VALUE = 95". "wd assist->get text( '001' ). 
INSERT LS TEXT INTO TABLE LT LABEL TEXTS. 


LS TEXT-NAME ='ZZNAME'. "must match a field in list structure 
LS TEXT-VALUE = "WEZ. "wd assist-7get text( '002' ). 
INSERT LS TEXT INTO TABLELT COLUMN TEXTS. 


T lv window title = wd assist-^get text( '003' ). 


lv group header = wd assist-^get text('004' ). 


T lv table header = wd assist-^get text( '005' ). 


OVS CALLBACK OBJECT-SET CONFIGURATION( 
LABEL TEXTS -LT LABEL TEXTS 
COLUMN TEXTS -LT COLUMN TEXTS 
GROUP HEADER - LV GROUP HEADER 
WINDOW TITLE -LV WINDOW TITLE 
TABLE HEADER - LV TABLE HEADER 
COL COUNT  -2 
ROW COUNT  -20) 


WHENIF WD OVS= CO PHASE 1. "set search structure and defaults 
In this phase you can set the structure and default values 

of the search structure. If this phase is omitted, the search 

fields will not be displayed, but the selection table is 

displayed directly. 

Read values of the original context (not necessary, but you 

may set these as the defaults). A reference to the context 


element is available in the callback object. 


OVS CALLBACK OBJECT->CONTEXT ELEMENT--GET STATIC ATTRIBUTES( 
IMPORTING STATIC ATTRIBUTES = LS SEARCH INPUT). 
xi pass the values to the OVS component 
OVS CALLBACK OBJECT->SET INPUT STRUCTURE( 
INPUT -LS SEARCH INPUT). 


WHEN IF WD OVS= CO PHASE 2. 
*  [fphase I is implemented, use the field input for the 
* selection of the table. 


If phase I is omitted, use values from your own context. 


IFOVS CALLBACK OBJECT->QUERY PARAMETERS IS NOT BOUND. 
eee TODO exception handling 

ENDIF. 

ASSIGN OVS CALLBACK OBJECT->QUERY PARAMETERS--* 

TO «LS QUERY PARAMS>. 

IF NOT «LS QUERY PARAMS IS ASSIGNED. 
eee TODO exception handling 

ENDIF. 


: call business logic for a table of possible values 
SELECT ZZNUMBER  ZZNAME FROM ZMNUMBER T 
INTO TABLE LT SELECT LIST. 
OVS CALLBACK OBJECT->SET OUTPUT TABLE( OUTPUT - LT SELECT LIST). 


WHEN IF WD OVS= CO PHASE 3. 
* apply result 


IFOVS CALLBACK OBJECT->SELECTION IS NOT BOUND. 
eee TODO exception handling 
ENDIF. 


ASSIGN OVS CALLBACK OBJECT->SELECTION->*#* TO «LS SELECTION». 
IF «LS SELECTION> IS ASSIGNED. 
OVS CALLBACK OBJECT->CONTEXT ELEMENT-^SET ATTRIBUTE( 
NAME -'ZZNUMBER' 
VALUE = «LS SELECTION--ZZNUMBER ). 
OVS CALLBACK OBJECT->CONTEXT ELEMENT-^SET ATTRIBUTE( 
NAME -'ZZNAME' 
VALUE = «LS SELECTION--ZZNAME ). 
$ Or 
ovs callback object-^context element-^set static attributes( 


static attributes — «Is selection? ). 


ZH 


ENDIF. 
ENDCASE. 


ENDMETHOD. 


60 f£ ABAP 工作 台中 的 Web Dynpro 应 用 编辑 界面 创建 Web Dynpro Application, Wi 
图 7-82 所 示 。 


LE Create Web Dynpro application 


Application [zwd input. help 
Description 学 生 检 索 
| 
图 7-82 
7) Æ ABAP 工作 台中 ， 测 试 结果 如 图 7-83 所 示 。 
学 生 信 息 
学 生 番号 :|00001 
Ez: Bp: 00001 
OVS: 00001 
Free: 00001 
姓名 : SEE | 
图 7-83 


目 动 弹出 的 输入 帮助 ， 如 图 7-84 所 示 。 


"PESE S: allgemeine Werteliste 


PersBliche VVerteliste Einstellungen... 


[~ Suchkriterien ausblenden 

学 生 学 号 Of | 中 

#& oL — 05 $5 — j|» 

Anzahl der Eintr&&e in der Werteliste einschr&&ken auf 


Zur persBlichen VWerteliste hinzuffgen 
EROR... 姓名 | 
E 00001 HEE 
` 0002 fre 
| 0003 £ 
| 0004 #88 
| |ooos + 
| o0 TER 
| 0007  X/&t- 
| 0008 Bs 
| 00009 RSR 


Weitere Suchhilfen: | 学 人生 查询 -党 号 |= 


图 7-84 
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检索 帮助 ， 如 图 7-85 所 示 。 


限制 : allgemeine Werteliste [m] E] 
PersBliche Vverteliste Einstellungen... 
| w Suchkriterien ausblenden 

eee 0 ° 


re oL — 0 Je 
Anzahl der Eintr&&e in der VVerteliste einschr$&ken auf 
- Suche starten || Zur&bksetzen 


Zur pers&lichen wwerteliste hinzuffgen 


l^ 
| | 00001 郑 喜 定 
| 00002 HEE 
` | 00003 $55 
` | 00004 HSE 
` | 00005 朴 喜 珍 
| 00006 FER, | 
x | 00007 EE | 
| 00008 ES | 
| 00009 ASA [vi 


7-85 


OVS 帮助 ， 如 图 7-86 rn. 


| + Suchkriterien ausblenden 


El 
n 
#3: 
姓名 :| — ] 
[z] 


00011 刘 训 位 
00012 HSA 


7-86 
自 定义 检索 帮助 ， 如 图 7-87 所 示 。 
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学 生 信息 
学 生 信息 一 览 
学 生 学 号 Ma [a 


00001 郊 言 定 | 一 
00002 HBE 
00003 ER 
00004 EE [v] 


图 7-87 


7.5 ABAP Web Dynpro 应 用 程序 的 帮助 文本 


ABAP Web Dynpro 可 使 用 多 种 方式 显示 帮助 文本 。 

帮助 文本 可 以 与 UI 元 素 相关 。 在 这 里 ， 工 具 提 示 也 是 常用 功能 。 用 户 将 光标 置 于 相关 
的 UI 元 素 上 ， 即 可 使 用 该 类 语义 帮助 显示 短 帮助 文本 。 说 明文 本 可 用 来 在 相关 学 段 下 方 耻 接 
显示 较 长 信息 文本 。 最 后 ， 还 可 以 在 ABAP Web Dynpro Context 中 使 用 标准 字典 Fl 帮助 。 

如 果 必 须 显 示 与 特定 UI 元 素 不 相关 的 一 般 帮 助 , 则 可 使 用 EXPLANATION 7628 « 227b, 
可 以 可 在 所 谓 的 “帮助 中 心 ” 加 载 并 显示 知识 仓库 中 所 定义 的 文档 。 

Web Dynpro 应 用 程序 (各 种 UI 元 素 视 图 ) 中 最 终 用 户 可 以 使 用 各 种 方式 显示 人 简短 的 帮 
助 文本 ， 也 可 以 在 一 个 完整 的 应 用 程序 或 窗 体 中 显示 较 长 的 文本 文档 。 

(1) UI 元 素 相关 帮助 文本 

可 采用 以 下 技术 将 帮助 文本 关联 到 指定 UI 元 素 。 

€ Explanation 7625. 

€ Explanation 属性 。 

e 典型 的 Fl 帮助 。 

(2) 应 用 程序 或 窗 体 (帮助 中 心 ) 相关 帮助 文本 

对 于 一 个 Web Dynpro 应 用 程序 或 窗 体 ， 可 以 存储 一 个 帮助 文本 (信息 对 象 )。 访 对象 信 
居 可 以 在 知识 库 (Knowledge Warehouse) 中 创建 。 要 做 到 这 一 点 ， 需 转 到 应 用 程序 或 窗 体 的 
属性 配置 页 面 。 

© Help Menu Text 处 指定 帮助 窗 体 的 标题 。 

e Help Link 处 指定 帮助 链接 所 需 知识 仓库 系统 的 信息 对 象 ， 可 以 使 用 输入 字段 的 石 

侧 标示 来 创建 或 者 修改 链接 。 为 此 需要 定义 到 知识 仓库 系统 的 RFC 连接 AIO FOR. 
HELP LINKS。 


MS 当 程序 员 选 择 知 识 仓库 中 的 相关 信息 对 象 时 ， 操 作 的 是 相关 生产 系统 和 相关 区 域 的 
知识 仓库 Context， 如 文档 。 当 选择 知识 仓库 中 的 信息 对 象 时 ， 有 以 下 选项 : 
@ 选择 一 个 主题 ， 继 而 选择 相关 的 结构 。 
e 选 题 一 个 主题 但 不 选择 结构 (不 选择 任何 结构 并 关闭 结构 选择 对 话 框 )。 
需要 注意 的 是 ， 知 识 库 中 的 主题 和 结构 必须 被 释放 。 
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用 户 还 可 以 为 Web Dynpro ABAP 程序 和 窗 体 定义 不 是 一 个 单一 的 而 是 多 个 帮助 链接 。 这 
些 额 外 的 帮助 链接 在 运行 时 通过 帮助 中 心 的 Helpful Links 显示 。 程 序 员 可 以 使 用 程序 
WDY AUTHORING HELP LINKS 创建 链接 。 

帮助 可 以 通过 在 运行 时 选择 Fl 或 标题 栏 中 的 “帮助 ”按钮 被 调用 。 然 后 该 帮助 中 心 和 该 
应 用 程序 的 窗 体 被 显示 。 对 快速 帮助 的 解释 、 知 识 仓库 文档 、SAP 库 的 链接 ， 以 及 定义 为 应 
用 程序 窗 体 的 帮助 链接 都 存储 在 帮助 中 心 。 

程序 员 可 以 在 应 用 程序 中 创建 一 个 链接 ， 这 样 应 用 程序 本 身 就 可 以 触发 帮助 中 心 。 进 行 
如 下 编程 : 

e ij. 

e 插入 一 个 LinkToAction 元 素 到 视图 。 

@ 插入 非 验 证 操作 。 

e 定义 下 列 源 代码 : 


data: ] api componentcontroller type ref to if wd component. 


data | appl type ref to if wd application. 


] api componentcontroller = wd comp controller-^wd get api( ). 
l appl - ] api componentcontroller-^get application( ). 
1 appl-^open help center( ). 


示例 : 
此 处 由 Help Center 连接 到 SAP 的 官方 网 站 ， 如 图 7-88 所 示 。 


Help Center 


Quick Help 
[ | Activate Quick Help 
Change: Right Mouse Key in Application --» Quick Help On/Off 


Application Help 


= j j ad 


ome SAP Library Getting Started Help on Help Hide Tree Sele ex arch Properties Lo 


fim 
ili Web Dynpro for ABAP 


P @ web Dynpro Architecture Purpose 
d Enn Web Dynpro ABAP: Development in Web Dynpro for ABAP (WD4A, WDA) is the SAP standard UI technology for 

— — .. developing Web applications in the ABAP environment. It consists of a runtime 

;加 mm environment and a graphical development environment with special Web Dynpro 

"ais arty sues n ng Dre tools that are integrated in the ABAP Workbench (SE80). 

» (à ee Web Dynpro offers the following advantages for application developers: 

f e The use of declarative and graphical tools significantly reduces the 

implementation effort 
e Web Dynpro supports a structured design process 


e Strict separation between layout and business data 
e° Reuse and better maintainability by using components 
e The layout and navigation is easily changed using the Web Dynpro tools 


e Stateful applications are supported — that is, if the page is changed and the 
required data remains intact so that you can access it at any time 


throughout the entire application context. s 
Display in Separate Window 
Helpful Links 
[Ell information Center 
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(3) 动态 重 写 应 用 程序 帮助 链接 

如 果 用 户 不 想 Web. Dynpro 应 用 定义 的 帮助 链接 显示 在 帮助 中 心 ， 而 是 显示 链接 到 其 他 
“帮助 ”主题 的 帮助 连接 ， 允 可 以 重 写 应 用 程序 帮助 动态 链接 。 要 做 到 这 一 点 ， 需 使 用 接口 
IF WD RR APPLICATION 的 方法 SET HELP. LINK 并 指定 APPLICATION INFO. 

示例 : 


method onactionchange appl helplink . 
data api main2 type ref to if wd view controller. 
data component type refto if wd component. 
data application type refto if wd application. 


data application info type ref to if wd rr application. 


api main2 = wd this wd get api( ). 

component = api main2-»get component( ). 
application = component-^get application( ). 
application info = application-^get application info( ). 


application info->set help link( 'HELPTYPE-SAPHELP& LOIO-452C8201E9EFA48D882BD10244D085661 & 
 CLASS-BIC OOO'). 
endmethod. 


注 : 可 以 在 系统 组 件 WDR TEST HELP 中 找到 示 倒 代码 。 


7.5.1 Explanation UI 7,35 


工具 提示 可 以 在 黄色 框 中 显示 短文 本 ， 最 大 长 度 为 255。 如 果 鼠 标 移动 到 分 配 有 工具 提 
示 的 字段 上 ， 就 会 出 现 该 框 。 如 果 鼠 标 从 该 字段 占用 区 域 移 开 ， 则 该 工具 提示 将 会 消失 。 

通过 设 定 相 应 属性 的 工具 提示 ， 可 将 工具 提示 分 配 到 UI 元 素 。 该 文本 可 在 属性 字段 中 输 
A, 来源 于 在 线 文 本 资源 库 COTR) 中 定义 的 别名 文本 可 以 是 Context 属性 的 内 容 ， 或 者 是 与 
数据 元 素 相关 的 文本 之 一 。 

根据 在 视图 的 UI 元 素 层次 结构 中 所 处 位 置 ， 工 具 提 示 可 由 其 他 的 UI 元 素 继承 。 

程序 员 可 以 在 视图 View 上 使 用 Explanation 元 素来 显示 解释 性 文本 。Explanation TRE 
合 一 个 文本 ， 可 以 显示 在 屏幕 上 ， 并 且 该 解释 应 该 包含 屏幕 或 部 分 屏幕 。 

在 视图 设计 器 中 ， 可 以 创建 文本 属性 的 解释 文本 。 文 本 可 以 是 手工 输入 (最 大 255 个 字符 )， 
也 可 以 是 一 个 OTR 别名 文本 ， 可 以 使 用 符号 $ OTR: Aliasname 访问 ， 还 可 以 写 一 个 脚本 ， 人 允许 文 
本 超过 255 个 字符 ， 可 以 是 各 种 格式 。 要 做 到 这 一 点 使 用 方法 WDDOMODIFYVIEW., 

示例 : 


method wddomodifyview. 
data lines type tlinetab. 
data header type thead. 
data text type string. 


data wad formatted text type ref to cl wd formatted text. 
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data ui explanation type ref to cl wd explanation. 
call function DOCU GET' 
exporting 
id -'TX' 
langu — sy-langu 
object —'WDR TEST HELP EXPI' 
importing 
head — header 
tables 
line = lines 
exceptions 
no docu on screen = 1 
no docu self def =2 
no docu temp =3 
ret code -4 
others = 5. 
if sy-subrc <> 0. 
text — space. 
endif. 


wad formatted text = cl wd formatted text=>create from sapscript( sapscript head = header 


apscript lines = lines 
type = cl wd formatted text=>e type-wad 
). 
if wad formatted text is bound. 
text = wad formatted text-^m xml text. 
else. 
MEX 
endif. 
ui explanation ?= view->get element( 'ON SCREEN EXPLI' ). 
ui explanation-^set text( text). 
wd this-^m view = view. 
endmethod. 


当 设 计 强 调 某 个 UI 元素 时 ， — T 368] x A isu 27, 与 其 他 的 用 户 界 面 文本 不 同 ， 文 本 
为 监 色 并 带 有 下 男 线 ， 开 关 标 示 Hide Quick Help 也 被 显示 。 

示例 : 

Explanation UI 2628, WB] 7-89 所 示 。 


This iz just 
a =Fiürt à; 

. " a a 
Explanation Hide (uick Help 
Ul element 


| 7-89 


与 帮助 中 心 连接 的 复杂 的 例子 ， 如 图 7-90 所 示 。 
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Purchasing Document Help: Personalzation 


Frank Mustermann Classification Data A-Customer Escalation Status Critical 
wWalldorf Web Page www muster01.com 
Help Center 
In the next step, you can make contact with the following business partners: — 
the customer Quick Help 
* the vendor || Activate Quick Help 
By choosing Complete Purchasing Document, you can automatically generate the relevant Change: Right Mouse Button in Application --» Quick Help On/Off 
data. 
Product | Contact Address for Customer Applic ation H elp 
Product: [5878 Customer Name: Frank Mustermann 
Description: [Pumpenwelte Telephone no: *49(6227)7 30000 ] im 
Quantity. [  100p00[ST | E-Mail Address: [trank mustermanngimuste Web Dynpro for ABAP 
Net Price: [| 270000|EUR Purpose 
Delivery Date; — (20.10.2006 It 
Tt Oma 
Ul technology for developing Web applications in the ABAP 
Chosen Vendor Alternative Vendor environment. It consists of a runtime environment and a 
Name: Test 0815 GmbH, Freiburg Name: Test 4711 Inc, Detrot graphical development environment with special Web Dynpro 
LA == tools that are integrated in the ABAP Workbench (SE80). 
Delivery Time; [004 [Day [>| Delivery Time: 004 [Day [>] 9 . ( ! ) 
; ; Web Dynpro offers the following advantages for application 
Contact Name: =—uMantfred Tester Contact Name: Nicole Miller | developers: x| 
T no. 123) 455-7890 : - 
elephone ( ) Telephone no: (7769678 9456 re s 
E-Mail Address: service@test0815.com E-Mail Address: nicole miller£otest4711.com PETERE 


Fax number: (123) 455-7891 Fax number: (857)-578-9466 
————— 一 -一 一 -一 Helpful Links 


"ert — 
ABAP Workbench (BC- 


图 7-90 


从 浏览 器 中 通过 Context 3 fu] PATE HI 6 PS SC KI ER (Quick Help On/Off), Wii 
图 7-91 所 示 。 


在 Context 菜单 中 ， 更 多 字段 帮助 (More Field Help) 选项 用 于 显示 技术 信息 以 及 更 全 面 
的 数据 元 素 的 文档 。 如 果 没 有 连接 到 ABAP， 则 只 显示 技术 信息 。 


7.5.0 Explanation 属性 


还 可 以 为 不 同 的 UI 元 素 设 置 Explanation 元 素 。 该 属性 是 否 显示 取决 于 帮助 模式 是 否 打 

开 或 天 闭 。 根 据 帮 助 模式 有 以 下 不 同 功 能 

(1) Help mode = on 

如 采 对 特定 的 UI J ix J Explanation 属性 , 则 该 UI 元 素 在 屏幕 上 显示 为 绿色 并 市 有 
下 男 线 。 如 采用 户 单 击 分 配 有 说 明文 本 的 UI 元 系 或 者 将 光标 移动 到 绿色 的 UI 元 素 标记 ， 则 
显示 该 属性 的 内 容 。 另外, 这 是 相对 独立 的 , 任何 UI 元 素 都 可 用 的 工具 提示 。 在 这 种 情况 下 ， 
属性 实际 上 包含 一 个 Fl 帮助 。 

示例 : 

Explanation 元 素 作 为 帮助 提示 ， 如 图 7-92 所 示 。 


Delivery Tire: BER Da — 
Contact w: d Delivery Time for the Goods Delivery 
(Right mouse click for more) 
Telephone no.: —— 
图 7-92 


: 提示 性 内 容 仅 在 读 取 模 式 下 由 屏幕 阅读 器 读 取 。 
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(2) Help mode = off 

说 明 内 容 不 显示 。 系 统 不 提供 主要 的 帮助 。 

在 门户 网 站 中 的 个 人 设置 或 相关 联 的 URL 参数 中 ， 可 以 激活 帮助 模式 。 

在 视图 设计 器 中 ， 可 以 为 该 属性 的 值 创建 输入 字段 中 的 Explanation 属性 的 文本 。 文 本 可 
以 是 手工 输入 (最 大 为 255 NEI, 也 可 以 是 一 个 OTR 别名 的 文本 。 该 文本 使 用 符号 $ OTR: 
Aliasname 可 以 访问 。 也 可 以 使 用 FA 帮助 指定 该 字段 的 数据 元 素 的 文档 或 它 的 一 部 分 作为 帮 
助 文本 显示 在 屏幕 上 。 这 将 是 数据 元 素 的 数据 元 和 素 文 要 ， 需 要 用 户 在 分 配 选 项 中 绑 定 属性 中 
的 主 属 性 (Primary Property)。 可 以 选择 下 列 显 示 变 量 为 数据 元 素 文 档 : 

ABAP 字典 中 的 短文 本 

e 数据 元 素 的 长 文本 中 关键 块 &DEFINITION& 的 定义 。 

e 数据 元 素 的 长 文本 中 关键 块 &USE& 的 定义 。 

e 完整 的 数据 元 文件 (长 文本 ) 的 链接 。 

当 鼠 标 指针 移动 到 相应 的 UI 元 素 时 ， 帮 助 文本 显示 在 屏幕 上 。 


注 : 如 果 UI 元 素 的 主 属 性 ( 即 输入 字段 的 值 属 性 ) 绑 定 到 Context 属性 ， 则 文本 还 可 
源 于 与 该 Context 属性 相关 的 数据 元 素 。 开 发 人 员 可 确定 是 否 显示 数据 元 素 中 存储 的 短文 本 、 
关键 块 &DEFINITION& 的 内 容 或 关键 块 &USE 人 的 内 容 ， 这 些 关键 块 来 自 于 数据 元 素 文 档 。 


各 种 帮助 选项 指定 如 图 7-93 所 示 。 


[LE Web Dynpro Explorer. Change View for HvG TEST. HELP1 s 


[v] with Mouse-Over Help Text 
®© From the Data Elemnt | 
O Short Descriptn 
@) Content of Keyblock &DEFINITION& 
O Content of Keyblock &USE& 
Show Reference to Complete Data Element Documentation 
O From an OTR Alias 
O From Individual OTR Text (Max. 255 Chars) 


x [ele] ele] (a 


[Ln 1 - Ln 1 of 1 lines 


lk 7-93 
要 显示 数据 元 素 的 文档 ,相应 的 UI 元 系 必 有 顷 有 主 属性 (Primary Property), 并 且 要 在 ABAP 
字典 中 绑 定 一 个 数据 元 素 到 数据 元 素 文 档 。 如 果 没 有 这 样 的 数据 元 素 ， 则 弹出 的 数据 元 素 文 
件 选项 是 灰色 的 。 在 这 种 情况 下 ， 显 示 数 据 元 系 文 档 是 不 可 能 的 ， 因 为 没有 设 定 主 属性 。 
示例 ; 
以 不 同方 式 显示 部 分 数据 元 系 文 档 的 例 和 于， 如 图 7-94 所 示 。 
E PERIT Goods Delivery | Kon rane Enter tho mea which the delivery is 


Telephone no.: 
图 7-94 


数据 元 素 WDR TEST HELP DELIVERY TIME， 左 边 为 文本 定义 C&DEFINITION&), 


expect 
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右边 为 文本 使 用 (&USE&O, WK 7-95 所 示 。 


[Ẹ Performance Assistant 


e [>e = [22] (Ga) (J (ma) 


DE WDR_TEST_HELP_DELIVERY_TIME 


Short Text 

Delivery Time 

Definition 

Delivery Time for the Goods Delivery 
Use 


Enter the time at which the delivery is expected here. 


图 7-95 


可 以 为 下 列 UI 元 素 设 置 Explanation 属性 : AbstractTableColumn, Button, CheckBox, 
DropDownByIndex, DropDownByKey., FileUpload. InputField. ItemListBox, RadioButton, 
TextEdit, TriStateCheckBox. 

(3) 关闭 Fl 帮助 

路 认 情况 下 ， 当 帮助 模式 被 激活 时 ， 将 显示 数据 元 系 文 档 。 但 是 也 可 以 关闭 数据 元 勾 文 
档 的 显示 并 为 个 别 字 段 定 义 例 外 。 应 用 参数 WDHIDEMOREFIELDHELPASDEFAULT 为 此 所 
供 相 应 功能 。 

如 果 该 参数 设置 为 X， 并 且 显 示 说 明 (Display Note) 为 所 有 数据 元 素 文档 (Full Data 
Element Documentation) 选项 是 激活 的 ， 并 且 帮 助 文 本 鼠标 选项 (Help Text for Mouse-Over? 
和 数据 元 素 〈From the Data Element). 的 菏 一 属性 关联 UI 7628 8] Explanation JE TES VE, TE 
文本 信息 后 的 括号 中 将 显示 单 击 鼠 标 右键 更 多 (Right Mouse Button for More) 的 字样 。 使 用 
鼠标 右键 单 击 更 多 字段 将 有 助 (More Field Help) 选项 显示 相关 的 数据 元 素 文 档 。 


7.5.3 Hi F1 帮助 


可 以 使 用 UI 元素 的 Fl 帮助 功能 (如 同 SAP GUI)。 要 做 到 这 一 点 ， 相 关 的 数据 元 素 的 文 
件 必 须 已 经 存在 于 系统 中 ， 内 容 元 素 必 须 将 EI 帮助 连接 到 一 个 ABAP 字典 字段 。 

用 户 可 以 使 用 组 合 键 (Ctrl+ F1》， 或 者 通过 在 Context 荣 单 中 选择 更 多 的 字段 帮助 选项 ， 
然后 显示 系统 的 文档 。 

示例 : 在 Web Dynpro ABAP 应 用 数据 元 素 文 档 的 例子 ， 如 图 7-96 所 示 。 


Mehr Feldhilfe 


Airfare 
Use 


This data element is used in the flight data model for demonstration and training purposes only. It is 
not intended for use in other applications. 


Dependencies 


The price takes into consideration any supplements or reductions that depend on the flight class or 
age of the passenger. 


图 7-96 
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1.6 ”消息 Messages 


在 Web Dynpro ABAP 中 ， 程 序 员 可 以 创建 和 显示 消 县 。 访 信息 包含 Web Dynpro 应 用 程 
序 与 最 终 用 户 交 互 的 重要 信息 。 消 息 依 赖 于 文本 语言 。 例 如 ， 如 果 一 个 应 用 程序 运行 时 发 生 
音 误 ， 或 者 用 户 输入 的 数据 格式 错误 ， 则 相应 错误 信息 显示 在 屏幕 上 。 


注 : NW7.0 SPS11 版 本 的 消息 和 消息 区 都 被 赋予 了 新 的 设计 ， 提 高 了 用 户 的 指导 ,是 类 
似 于 旧 的 设计 。 新 的 设计 是 默认 设置 。 不 过 ， 也 可 以 切换 到 旧 的 设计 。 

示例 : 

用 户 检 查 ， 如 图 7-97 Ff +. 


@ ThisisaT100 message 
A Error in STRDBMON/ENDDBMON command; choose F1 HELP for assistance - Display Help 


B Error in authorization check, error code 8; choose F1 HELP for more info. - Display He 


图 7-97 


对 于 这 些 用 户 信 息 ， 如 信息 (Information). iR S (error) AZ (warnings), ABAP 
应 用 程序 服务 器 在 Web Dynpro 运行 时 提供 了 运行 时 服务 。 消 恩 组 件 是 Web Dynpro 应 用 程序 的 
一 部 分 ， 如 条 需要 可 在 Web Dynpro 应 用 程序 的 设置 中 配置 。 有 以 下 3 种 可 能 处 理 消 轧 的 设置 : 

D 如 果 需 要 ， 显 示 消 息 组 件 ， 如 图 7-98 所 示 。 


Wi The Entered value Iz Mot on the List of valid values. 


Input Fields 
String Input (Only 'ABC' and 'DEF' Allowed): 


图 7-98 


ap RE E. Due p IB. 
示例 : 
2) 始终 显示 消息 组 件 ， 如 图 7-99 Bp. 


“> Ho Messages 


Input Fields 
String Input (Only 'ABC' and 'DEF' Allowed]: 
KK] 7-99 
即使 没有 消 县 ， 该 消息 仍然 显示 组 件 在 项 视图 中 。 


示例 : 
3) 无 消息 组 件 显示 消息 ， 如 图 7-100 所 示 。 


Input Fields 


String Input (Only '&BC' and 'DEF' Allowed): Idefaultstring fm] 


图 7-100 
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PH RH. f RETI RS. A TARRAK BERE HUS — B on. CH IH 
E His 

此 选项 仅 适 用 于 较 小 的 测试 应 用 程序 。 

用 户 消息 显示 在 状态 栏 的 链接 中 。 在 钳 误 报告 中 ， 用 户 可 以 使 用 链接 导航 到 可 用 于 删除 
错误 的 UI 元 素 。 输 入 的 焦点 是 目 动 传输 ， 从 而 大 大 增加 了 信息 效率 。 它 也 可 以 在 屏幕 上 显示 
Z^ BB. 

程序 员 可 以 指定 消息 显示 在 具体 的 视 网 和 窗 体 中 , 这 样 消 息 就 会 实时 地 显示 在 主 窗 体内 ， 
而 不 是 显示 在 弹出 的 窗 体 内 。 要 做 到 这 一 点 , 可 以 在 消 县 管理 融 的 方法 中 使 用 可 选 参数 VIEW 
指定 有 天 的 视图 或 窗 体 的 名 称 。 

消 朋 要 定义 在 一 个 Web Dynpro 组 件 的 级 别 。ABAP 开 及 工具 包括 一 个 消息 维护 的 图 
J 


7.6.1 ”消息 弹出 


弹出 消息 显示 是 标准 配置 的 需求 ， 无 论 在 应 用 程序 中 是 如 何 设 置 的 。 
弹出 窗 体 可 以 配置 一 个 标示 用 于 显示 : 

e 所 有 的 信息 ， 如 截至 目前 (标准 设置 )。 

e 只 有 那些 属于 目 己 的 窗 体 ， 以 及 所 有 无 窗 体 特定 的 消 居 。 

e ARENIS. 

(1) 基本 功能 

1) 显示 ， 如 图 7-101 所 示 


Hide hlessadge Logi 


Current Messages ¿ | Log ENS 
| 
Type — Message Text 二 Hep X Time Stamp 5 [4] 
"Ë Al hl | 


Ë] Error in autharization check, error cade 8: choose F1 HELP for more infa. Display 17.11.2006, 12:22:10 
e Error in STRDBMON/ERNDDEBION command; choose F1 HELP for assistance | Display 17.11.2006, 12:22:10 B 


图 7-101 


e Higgs BI AB Se 

e iue. ERAH KIRA Ex JUftifmsmmpoE. 
e ^V RU A AAI AAT o 

e 标示 每 个 消息 权重 的 符 扎 。 

e 所 有 消息 的 时 间 标 示 。 

2) BFAA E, Hi^ du ERE ORA BEBE 
3) 消 恩 在 标签 条 中 按照 下 列 条 件 排 序 。 

e 权重 。 

e x. 

e 事件 标示 。 
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4) 通过 过 滤 标 准 可 输入 : 

e NE. 

e v. 

e 事件 标示 。 

5) OBERE TH B! I BIER 5 BU TES Hos e 

6) 显示 和 隐藏 消 忆 mE 

e [uk RALÉ Ea — ASH LR AVEC U AA 21. 

e ios. SPE ARIER Aes e ARCHIE EZR o 

(2) 集成 

在 应 用 程序 开发 中 ， ein 
程 是 将 消 居 集 成 到 消 恩 日志 

示例 : 系统 组 件 WDR MESSAGE AREA 和 WDR TEST INPUT. 


7. 6. 2 ili H 志 中 的 消 , EHK 


TH INE |J EH TRE SEE Ee PRR AE qil s (接口 IF WD MESSAGE ` 
MANAGER)。 消 息 管理 器 通过 代码 向 导 〔( 外 部 ) 被 集成 到 Web Dynpro。 以 下 方法 用 于 触发 
消息 。 

1) CLEAR MESSAGES: 删除 所 有 消息 。 

2) IS EMPTY: 查询 消息 是 否 存在 。 

3) REPORT ATTRIBUTE ERROR MESSAGE: 报告 一 个 Context 属性 的 Web Dynpro 
例外 。 

4) REPORT ATTRIBUTE EXCEPTION: 报告 一 个 Context 属性 的 Web Dynpro 例外 。 

5) REPORT ATTRIBUTE T100 MESSAGE: 报告 一 个 Context 属性 的 Web Dynpro 例外 。 

6) REPORT ERROR MESSAGE: 报告 一 个 珊 有 可 选 参 数 的 Web Dynpro 消息 。 

7) REPORT EXCEPTION: 报告 一 个 Web Dynpro 例外 〔( 它 可 以 返回 )。 

8) REPORT FATAL ERROR MESSAGE: 报告 一 个 致命 的 带 有 可 选 参 数 的 Web Dynpro 
消息 。 

9) REPORT FATAL EXCEPTION: 报告 一 个 致命 的 Web Dynpro 消息 。 

100 REPORT SUCCESS: 报告 成 功 消息 。 

11) REPORT T100 MESSAGE: 报告 一 个 消息 ， 使 用 T100 条 目 。 

12) REPORT WARNING: 报告 警告 。 


注 : 消息 管理 的 RAISE 方法 是 过 时 的 。 因 为 这 个 原因 ， 程 序 员 不 应 该 使 用 它 。 有 关 的 方 
法 ， 可 以 使 用 可 选 和 参数 视图 输入 要 显示 消息 的 窗 体 或 视图 的 名 称 。 


示例 : 


whe T100 JE 
* get message manager 


data: l current controller type ref to if wd controller, 
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] message manager type ref to if wd message manager. 
] current controller ?= wd this wd get api( ). 
call method ] current controller-^get message manager 
receiving 
message manager =] message manager. 


* report message 


call method] message manager-^report t100 message 


exporting 
msgid = bc”? 
msgno ='005” 
msgty —'e' 
*P1 = 

* P2 = 

x P3 = 

* P4 = 


7.6.3 ”配置 消 忌 


可 以 配置 消息 是 如 何在 应 用 程序 的 视图 或 窗 体 级 别 显 示 的 。 要 做 到 这 一 点 ， 需 在 方法 
WDDOINIT 中 加 上 上 下面 的 源 代码 ， 其 体 参数 见 表 7-1. 
data: 
] api mycomp type refto if wd window controller, 


] wd message areatype ref to if wd message area. 


l api mycomp ?= wd this-wd get api( ). 


] wd message area =] api mycomp-»get message area( ). 


| wd message area-»set display attributes(i for all instances = '' 
i msg lines visible = '0' 


i use toggle area =' 


i show only current = ' ' ). 


A 7-1 
设 — E yi HJ 
i use toggle area ='' 消息 区 《〈 默 认 设 置 ) 的 新 设计 
i use toggle area='X 消息 区 的 旧 设 计 《〈 可 切换 新 设计 ) 
i msg lines visible = 0 所 有 的 消息 都 立即 可 见 〈 默 认 设 置 ) 
i msg lines visible = «x^ x>0。 只 有 X 的 消息 立即 可 见 ， 其 余部 分 滚动 时 可 见 
i show only current = 'X' 与 参数 一 并 设置 为 i_use toggle area ="， 这 意味 着 任何 消息 日 志 可 以 显示 (默认 设置 ) 
i show only_current="" 与 参数 一 并 设置 为 1 use toggle area ="， 这 意味 着 一 个 链接 连接 到 消息 日 志 可 以 显示 


注 : 程序 员 可 以 在 程序 代码 中 删除 消息 记录 。 要 做 到 这 一 点 ， 需 使 用 方法 RESET 
MESSAGES. 
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7.6. ”重用 组 建 科 MessageArea Jt% 


如 果 程 序 员 使 用 可 重用 组 件 ， 则 需 确 保 组 件 中 包含 可 重用 的 元 素 。 可 重用 组 件 要 使 用 在 多 个 
应 用 中 ， 不 能 使 用 MessageArea UI 元 素 ， 由 于 每 个 窗 体 最 多 可 以 只 包含 一 个 可 见 的 消息 区 。 

举 一 个 例子 ， 组 件 可 以 是 独立 的 和 可 重用 的 。 创 建 了 两 个 视图 ， 第 一 个 视图 只 包含 不 会 
被 重复 使 用 的 UI 元 素 ， 如 Header. MessageArea 和 ViewContainer。 第 二 个 视图 只 包含 可 通 入 
和 重用 的 核心 应 用 程序 。 在 组 件 中 创建 两 个 窗 体 。 第 一 个 是 运行 独立 应 用 程序 的 默认 窗 体 。 
在 这 里 ， 典 入 第 一 视图 。 把 第 二 个 视图 放 在 UI 元 素 ViewContainer 中 。 第 二 个 窗 体 作为 界面 
视图 ， 用 来 钥 入 到 第 二 个 视图 。 


7.6.5 ”编辑 Web Dynpro 应 用 程序 


下 面 的 例子 通过 上 自 定义 的 组 件 辅 助 类 完成 信息 操作 。 

1) 在 ABAP 工作 台中 的 编辑 界面 创建 Web Dynpro 组 件 。 

选择 “Web Dynpro Comp./Intf.”, 在 相应 的 文本 框 中 输入 程序 的 名 称 ， 如 图 7-102 所 示 。 
Web Dynpro Comp. / Intf. = 


Izwp MESSAGE O [ela] 


图 7-102 


单 击 图 7-102 'h J| &e zH, BEHR 7-103 所 示 。 


LE Web Dynpro: Component / Create Interface 


Name ZWD MESSAGE 
Description 信息 栏 及 信息 应 用 
Type (e) Web Dynpro Component 


(Web Dynpro Component Interface 


Window Name W NESSAGE 
View Name "WV MAIN 


图 7-103 


2) ABAP 工作 台中 的 编辑 界面 创建 Web Dynpro 组 件 辅助 类 ， 如 图 7-104 所 示 。 


Web Dynpro Component ZW D MESSAGE | Inactive 

Description IE B EIS BEL 

Assistance Class 'ZCL MESSAGE ASSISTANCE 

Created By BCUSER | Created On 2011/10/28 
Last Changed By BCUSER | Changed On 2011/10/26 
Original Lang. ZH Package ZWD TRAINING 


[v] Accessibility Checks Active 
lk] 7-104 
22) 


编辑 辅助 类 文本 符号 ， 如 图 7-105 所 示 。 


Class IZCL MESSACE ASSISTANCE | Inactive 


Sym Text dLen mien 


001 数字 需 大 于 4 12 18 
- (002 数字 在 100 以 内 。 15 23 
. 003 数字 刚刚 好 12 18 
O |D04 数字 在 334 弄 666 之 间 。 20 20 
| [005 煞 字 在 667 弄 900 之 间 。 20 20 
| [006 数字 &P1 大 于 900。 18 18 
m š 

图 7-105 


编辑 辅助 类 属性 如 图 7-106 所 示 。 


Klassenschnittstelle | AZUL MESSAGE ASSISTANCE 已 实现 / 
i “Methoden Ereignisse V Typen | 别名 


A Eigenschaften “Interfaces | Friends ~ Attribute 


|=] | BETTER H sa 
属性 SaO |m.. Aig |Typisieru... | 参考 打印 说 明 初始 值 
TEXT NUM Constant Public C | m rere 
CONTEXT_ATTR ConstantPubic [] Type STRING | 5 contexte 'NUMBERS' 
[| Type 
图 7-106 


Ah S | 按钮 ， 编 辑 常 量 TEXT NUM 如 下 : 


CONSTANTS: 
BEGIN OF TEXT NUM, 
N001 TYPE WDR TEXT KEY VALUE '001', 
N002 TYPE WDR TEXT KEY VALUE '002', 


N003 TYPE WDR TEXT KEY VALUE '003', 
N004 TYPE WDR TEXT KEY VALUE '004', 
N005 TYPE WDR TEXT KEY VALUE '005', 
N006 TYPE WDR TEXT KEY VALUE '006', 
ENDOF TEXT NUM. 


3) 在 ABAP 工作 台中 的 编辑 界面 编辑 OTR 文本 ， 如 图 7-107 所 示 。 


~ J ZWD_TRAINING 


. B 数字 在 334 到 666 之 间 。 zwWD_TRAINING/EXCEPTION_WANGMING BCUSER 
. B 数字 在 667 到 900 之 间 。 ZWD TRAINING/EXCEPTION ERROR BCUSER 
图 7-107 


具体 Text 文本 编辑 如 图 7-108 和 图 7-109 所 示 。 
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Æ Change Text 


Alias Name | ZWD TRAINING/EXCEPTION WANGMING | 


Text Length 


s = seez [B]. 


7-108 


[=> Change Text 


Alias Name | ZWD TRAINING/EXCEPTION ERROR | 


Text Length [25 | 


EXTUS 300 I]. 


7-109 


编辑 Context 节点 如 网 7-110 所 示 。 


View "Wo NAIN | Inactive(revised) 
i i Inbound Plugs |" Outbound Plugs ^ Context | 


Context V. MAIN | "E <a 


7 O CONTEXT Context COMPONENTCONTROLLER 
MU nu - (Ü) CONTEXT 
* "3 NUMBERS 
7-110 
选择 “Layout” 选 项 卡 ， 如 图 7-111 所 示 。 
View V MAIN | Inactive(revised) 
/ Properties Inbound Plugs Outbound Plugs Context Attributes Actions Methods 


* L] CONTEXT. MENUS 


text | — MESSAGE AREA ~ D] ROOTUIELEMENTCONTAINER 


uem —À| 数字 : [V. MAIN.NODE. COMPU [S emer 


= f - Kg NUMBERS 


7-111 
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为 按钮 “确认 ”编辑 Action 如 图 7-112 所 示 。 


[=> Create Action x 
Component ZWD MESSAGE 

View V MAIN 

Action CONFIRM 

Description TALA, 


Select an outbound plug or enter an 

outbound plug for leaving the view 

by selecting the pushbutton 

Outbound Plug 


图 7-112 
编辑 方法 如 下 : 


METHOD ONACTIONCONFIRM . 
DATA LO ND NODE COMPUTER TYPE REF TOIF WD CONTEXT NODE. 
DATA LO EL NODE COMPUTER TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LS NODE COMPUTER TYPE WD THIS--ELEMENT NODE COMPUTER. 


* navigate from «CONTEXT» to «NODE COMPUTER- via lead selection 
LO ND NODE COMPUTER = WD CONTEXT--GET CHILD NODE( NAME = WD THIS-> 
WDCTX NODE COMPUTER ). 
* get element via lead selection 
LO EL NODE COMPUTER = LO ND NODE COMPUTER--GET ELEMENTN( ). 
* get all declared attributes 
LO EL NODE COMPUTER--GET STATIC ATTRIBUTES( 
IMPORTING 
STATIC ATTRIBUTES = LS NODE COMPUTER ). 
IFLS NODE COMPUTER-NUMBERS — 1. 
WD THIS->SET ERROR( 


). 


ELSEIF LS NODE COMPUTER-NUMBERS>=2 AND LS NODE COMPUTER-NUMBERS <= 100. 
WD THIS--SET WARNING( 
). 

ELSEIF LS NODE COMPUTER-NUMBERS >= 101 AND LS NODE COMPUTER-NUMBERS 


WD THIS->SET SUCCESS( 


). 
ELSEIF LS NODE COMPUTER-NUMBERS >= 334 AND LS NODE COMPUTER-NUMBERS 


WD THIS-^SET EXCEPTION WARNING( 
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). 
ELSEIF LS NODE COMPUTER-NUMBERS >= 667 AND LS NODE COMPUTER-NUMBERS 


WD THIS--SET EXCEPTION ERROR( 


). 
ELSE. 
WD THIS--SET ERROR PARM( 


Di 


ENDIF. 


ENDMETHOD. 


XEjE “Methods” HMR, WAAMBIA, WE 7-113 R. 


| View V MAIN Inactive 


W Inbound Plugs | Outbound Plugs ^ Attributes | Actions 


* Layout Methods 


Properties 


| Ë do |^ j6 


Method 


Method Type |Description Event Controller 


ONACTIONCONFIRM Event H. * 确认 
WDDOABTERACTION Method  "* 
WDDOBEFOREACTION Method  "* 
WDDOEXIT Method * Cleanup Method of Controller 
WDDOINIT Method "* Initialization Method of Controller 
WDDONODIPFYVIEW Method — * Method for Modifying the View Before Rendering 
WDDOONCONTEZXTMENU Method Y 
sRT  SUCCESZ Method ”| 成 功 信息 
sET WARNING Method ~ €815R 
cRT ERROR Method ~ isla B. 
SET_ERROF_PARM Wethod ~ ikia- mA 
sET EXCEPTION ERROR Method 三 异常 错误 信息 
cRT ERCRPTION VARNING Method ë ~ Ea B. 
Method ™ 


图 7-113 
SET SUCCESS 方法 : 


METHOD SET SUCCESS . 

DATA:L TEXT TYPE STRING. 
* 取得 文字 

L TEXT- 

WD ASSIST--IF WD COMPONENT ASSISTANCE-GET TEXT(WD ASSIST->TEXT NUM-N003). 
* get message manager 

DATA:L CURRENT CONTROLLER TYPE REF TO IF WD CONTROLLER, 

L MESSAGE MANAGER TYPE REF TO IF WD MESSAGE MANAGER. 
L CURRENT CONTROLLER ?= WD THIS->WD GET API(). 
L MESSAGE MANAGER =L CURRENT CONTROLLER-GET MESSAGE MANAGER( ). 


* report message 
L MESSAGE MANAGER-^REPORT SUCCESS( 
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MESSAGE TEXT -L TEXT 
* PARAMS E 


* MSG USER DATA = 


). 
ENDMETHOD. 


SET WARNING 方法 : 


METHOD SET SUCCESS. 
DATA:L TEXT TYPE STRING. 
t 取得 文字 
L TEXT= WD ASSIST-IF WD COMPONENT ASSISTANCE-GET TEXT( WD ASSIST-^TEXT 
NUM-N003 ). 
* get message manager 
DATA:L CURRENT CONTROLLER TYPE REF TOIF WD CONTROLLER, 
L MESSAGE MANAGER TYPE REF TO IF WD MESSAGE MANAGER. 
L CURRENT CONTROLLER ?= WD THIS-^WD GET API( ). 
L MESSAGE MANAGER = L CURRENT CONTROLLER-^-GET MESSAGE MANAGER( ). 
* report message 
L MESSAGE MANAGER-^REPORT SUCCESS( 
MESSAGE TEXT =L TEXT 
PARAMS = 
MSG USER DATA = 
j 
ENDMETHOD. 


SET ERROR 方法 : 


METHOD SET ERROR. 


DATA:L TEXT TYPE STRING. 
* get message manager 
L TEXT = WD ASSIST-IF WD COMPONENT ASSISTANCE-GET TEXT( WD ASSIST-> 
TEXT NUM-N001 ). 
DATA:L CURRENT CONTROLLER TYPE REF TO IF WD CONTROLLER, 
L MESSAGE MANAGER TYPE REF TO IF WD MESSAGE MANAGER. 
L CURRENT CONTROLLER ?= WD THIS-WD GET API(). 


L MESSAGE MANAGER =L CURRENT CONTROLLER-^GET MESSAGE MANAGERY( ). 
* report message 
L MESSAGE MANAGER-^REPORT ERROR MESSAGE( 
MESSAGE TEXT =L TEXT 
PARAMS = 
MSG USER DATA = 


). 
ENDMETHOD. 
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SET ERROR PARM 方法 : 


METHOD SET ERROR PARM. 
DATA:L TEXT TYPE STRING, 
L VALUE TYPE I, 
L PARAMS TYPE WDR NAME VALUE LIST, 
L PARAM TYPE WDR NAME VALUE. 
DATA LO ND NODE COMPUTER TYPE REF TOIF WD CONTEXT NODE. 
DATA LO EL NODE COMPUTER TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LS NODE COMPUTER TYPE WD THIS--ELEMENT NODE COMPUTER. 
* navigate from «CONTEXT» to «NODE COMPUTER- via lead selection 
LO ND NODE COMPUTER = WD CONTEXT--GET CHILD NODE( NAME = WD THIS-> 
WDCTX NODE COMPUTER ). 
* get element via lead selection 
LO EL NODE COMPUTER = LO ND NODE COMPUTER->GET _ ELEMENT( ). 
* get single attribute 
LO EL NODE COMPUTER--GET ATTRIBUTE( 
EXPORTING 
NAME = WD ASSIST-CONTEXT ATTR 
IMPORTING 
VALUE-L VALUE ). 


L TEXT = WD ASSIST--IF WD COMPONENT ASSISTANCE-GET TEXT( WD ASSIST 
TEXT NUM-N006 ). 
L PARAM-NAME = "Pl". 
L PARAM-VALUE =L VALUE. 
APPEND L PARAM TOL PARAMS. 
* get message manager 
DATA:L CURRENT CONTROLLER TYPE REF TO IF WD CONTROLLER, 
L MESSAGE MANAGER TYPE REF TO IF WD MESSAGE MANAGER. 
L CURRENT CONTROLLER ?= WD THIS->WD GET API(). 
L MESSAGE MANAGER =L CURRENT CONTROLLER->GET MESSAGE MANAGER( ). 


* report message 
L MESSAGE MANAGER-^REPORT ERROR MESSAGE( 
MESSAGE TEXT =L TEXT 
PARAMS =L PARAMS 
MSG USER DATA = 


). 


ENDMETHOD. 


SET EXCEPTION ERROR 方法 : 


METHOD SET EXCEPTION ERROR. 
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* 


* 


DATA:L EXC TYPE REF TO CX WDR DEMO MESSAGES. 
CREATE OBJECT L EXC. 
get message manager 
DATA:L CURRENT CONTROLLER TYPE REF TO IF WD CONTROLLER, 
L MESSAGE MANAGER TYPE REF TO IF WD MESSAGE MANAGER. 


L CURRENT CONTROLLER ?= WD THIS-WD GET API(). 
L MESSAGE MANAGER =L CURRENT CONTROLLER--GET MESSAGE MANAGER( ). 


report message 
L MESSAGE MANAGER-^REPORT EXCEPTION( 
MESSAGE OBJECT -L EXC 
MSG USER DATA = 
MESSAGE TYPE =L MESSAGE MANAGER-»CO TYPE ERROR 
). 


ENDMETHOD. 


SET EXCEPTION WARNING 方法 : 


METHOD SET EXCEPTION WARNING. 


* 


DATA:L EXC TYPE REF TO CX WDR DEMO MESSAGES, 
L VALUE  TYPEI, 
L ELEMENT TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LO ND NODE COMPUTER TYPE REF TOIF WD CONTEXT NODE. 
DATA LO EL NODE COMPUTER TYPE REF TOIF WD CONTEXT ELEMENT. 
DATA LS NODE COMPUTER TYPE WD THIS--ELEMENT NODE COMPUTER. 
navigate from «CONTEXT» to «NODE COMPUTER> via lead selection 
LO ND NODE COMPUTER = WD CONTEXT--GET CHILD NODE( NAME = WD THIS-> 


WDCTX NODE COMPUTER ). 
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* 


get element via lead selection 
LO EL NODE COMPUTER = LO ND NODE COMPUTER->GET ELEMENTN( ). 


TRY. 
get message manager 
DATA:L CURRENT CONTROLLER TYPE REF TO IF WD CONTROLLER, 
L MESSAGE MANAGER TYPE REF TOIF WD MESSAGE MANAGER. 
L CURRENT CONTROLLER ?= WD THIS-^WD GET API(C ). 
L MESSAGE MANAGER =L CURRENT CONTROLLER-^GET MESSAGE MANAGER( ). 
report message 

L MESSAGE MANAGER-^REPORT ATTRIBUTE EXCEPTION( 

MESSAGE OBJECT =L EXC 

ELEMENT = LO EL NODE COMPUTER 

ATTRIBUTE NAME = WD ASSIST-CONTEXT ATTR 

MSG USER DATA = 


MESSAGE TYPE =L MESSAGE MANAGER-^CO TYPE WARNING 
). 


ENDTRY. 
ENDMETHOD. 


4) 使 用 事务 代码 SE61， 编 辑 常规 文本 ， 如 图 7-114 所 示 。 


ËR ARa: Z NUMBER HELP zig ZH 
^ qdaa | A 4 o 行 格式 化 页 号 ui 


+ — XE EET RO: 


LZ 
T1 NO. 1 k<1 错误 
Tl 2...100 2é&«100 警告 


Ti 101...333 1014&«4333 成 功 

Tl 334...666 3344&k«566 警告 异常 
T1 667...900 B67<8&<900 HR E 
Tl 901... 901<& PEHA 


图 7-114 


5) 编辑 Web Dynpro Application 如 图 7-115 所 示 。 


[=> Create Web Dynpro application 


Application Izwd message 


Description BEES BE 


图 7-115 


6) 运行 结果 如 下 : 
输入 1， 如 图 7-116 所 示 。 


D 数 宇 需 太 于 1， 


图 7-116 


输入 3， 如 图 7-117 所 示 。 


心 数字 在 100 以 内 。 


图 7-117 
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输入 113， 如 图 7-118 Pro. 
[Z] 数字 同 同 好， 
图 7-118 
输入 335， 如 图 7-119 所 示 。 
d 数字 在 334 到 666 之 间 。 
图 7-119 
输入 667， 如 图 7-120 所 示 。 
(ay 数 宇 在 667 习 le00 之 间 。 
图 7-120 


输入 1000， 如 图 7-121 所 示 。 


DHF 1000 大 于 900。 


图 7-121 


1.1 Suspend 和 Resume 调用 


在 很 多 情况 下 ， 想 定位 到 独立 运行 的 第 二 个 应 用 程序 ， 还 不 能 关闭 第 一 个 应 用 程序 ， 在 
Web Dynpro ABAP 程序 中 ， 挂 起 (Suspend) MKE (Resume) 调用 是 很 有 用 的 。 要 使 用 暂 
停 和 恢复 调用 , 可 以 从 一 个 Web Dynpro 窗 体 的 界面 视图 中 选择 任何 出 站 或 入 站 插 涉 作为 挂 起 
插头 (Suspend Plugs ) 或 者 恢复 插头 (Resume Plugs)。, 挂 起 插头 调用 类 似 于 退出 插头 (Exit Plugs) 
调用 ， 都 是 用 于 退出 活动 的 Web Dynpro ABAP 应 用 。 区 列 于 退出 插 涉 的 是 ， 它 使 用 户 在 使 用 
了 为 一 个 单独 的 应 用 程序 之 后 返回 到 原来 的 应 用 程序 。 原 来 的 应 用 只 是 暂时 集 用 或 暂停 ， 不 
会 被 关闭 。 它 可 以 通过 调用 恢复 插头 重新 激活 。 

可 以 在 Web Dynpro ABAP 应 用 程序 中 设置 一 个 挂 起 插头 来 调用 以 下 程序 : 

1) 另 一 个 Web Dynpro 应 用 程序 。 
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2) 使 用 不 同 的 技术 的 Web 应 用 程序 (如 BSP). 

由 于 挂 起 和 恢复 插头 用 于 活动 的 应 用 程序 之 间 进 行 通信 ， 它 们 必须 添加 到 访 窗 体 的 接口 
WER. RET TERI GR URL 参数 ， 参 数 在 这 里 是 强制 性 的 ， 不 是 可 有 可 无 的 ， 这 一 点 
不 像 退 出 插头 。 当 一 个 挂 起 的 插头 被 调用 时 ， 必 须 指定 目标 URL. 

如 果 至 少 有 一 个 挂 起 插头 在 接口 视图 中 创建 ， 则 也 必须 创建 一 个 恢复 插头 。 没 有 恢复 插 
头 ， 应 用 程序 在 挂 起 后 不 能 被 重新 激活 。 每 一 个 的 Web Dynpro 窗 体 中 只 可 以 有 一 个 恢复 插头 
可 以 被 定义 。 

(1) 挂 起 一 个 Web Dynpro ABAP 应 用 程序 

这 是 很 容易 设立 一 个 挂 起 的 调用 : 首先 ， 在 主 WDA 应 用 程序 中 选择 出 站 插头 作为 挂 起 
插头 。 调 用 插头 时 ， 作 为 URL 参数 的 值 指 定 一 个 字符 串 ， 表 示 目 标 应 用 程序 的 URL (请 参阅 
下 面 的 示例 代码 )， 如 图 7-122 所 示 。 


primary secondary 
WDA Application => Web Application 


Web Dynpro 
ABAP Application 


图 7-122 


method ONACTIONGO SUSPENDING . 

data: L REF MAIN WINDOW type ref to IG MAIN WINDOW . 

L REF MAIN WINDOW-* WD THIS—GET MAIN WINDOW CTR( ). 
L REF MAIN WINDOW--FIRE GO SUSPENDING PLG( 


URL = "http:;//.../webdynpro/sap/my secondary wda' ). 


endmethod 


Web Dynpro 应 用 程序 的 URL 在 相关 的 标签 页 中 被 定义 为 应 用 程序 属性 之 一 ， 它 可 以 从 
这 里 访问 。 

在 第 二 个 WDA 应 用 程序 中 ， 当 退出 插头 触发 时 ， 该 应 用 程序 被 关闭 ， 并 且 目 动 调用 主 
应 用 程序 的 恢复 插头 。 在 Web Dynpro 框架 内 ， 主 程序 的 活动 实例 的 引用 总 是 在 挂 起 调用 时 转 
移 。 第 二 个 应 用 程序 知道 它 的 状态 ， 作 为 挂 起 的 主 应 用 程序 随后 的 应 用 程序 ， 在 其 中 当 使 用 
指定 引用 的 一 个 退出 插头 被 调用 时 会 返回 到 主 应 用 程序 的 恢复 插头 。 在 这 种 情况 下 ， 没 有 进 
一 步 的 编程 的 必要 了 。 

(2) 挂 起 一 个 非 Web Dynpro ABAP 应 用 程序 

创建 一 个 挂 起 的 调用 到 一 个 非 WDA 的 应 用 ， 因 为 也 需要 在 第 二 个 应 用 中 修改 ， 这 是 非 
第 困难 的 。 例 如 , 程序 员 必 须 实 施 返 回 到 主 应 用 程序 的 机 制 , 以 及 指定 第 二 个 应 用 程序 的 URL 
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地 址 和 强制 性 参数 ， 还 需要 在 随后 返回 步骤 中 指定 目 己 应 用 程序 的 URL, 3090 28 PARTI TCR 
URL， 作 为 参数 这 也 传递 到 第 二 个 应 用 程序 中 ， 如 图 7-123 所 示 。 

URL 必须 在 第 二 个 应 用 程序 中 被 恋 取 。 从 而 在 第 二 个 应 用 程序 的 浏览 右 中 重 定 癌 到 恢复 
插头 传 过 来 的 URL， 然 后 打开 浏览 右 窗 口中 的 二 次 应 用 。 


primary secondary 
WDA Application > Web Application 


Parameter URL+ 
Resume URL 


Redirect 
Location.href= 
<ResumeURL> 


图 7-123 


主 程序 通过 恢复 插头 的 URL 被 调用 ， 被 重新 激活 。 
挂 起 和 恢复 插头 ， 可 以 有 用 户 定义 的 参数 。 


注 : 挂 起 和 恢复 调用 在 门户 环境 中 没有 发 布 。 


下 面 介 绍 窗 体 中 出 、 入 站 插头 的 参数 。 

(1) 入 站 插头 和 出 站 插头 类 型 为 Standard 的 参数 

对 于 每 一 个 标准 次 型 的 出 站 插头 ， 程 序 员 可 以 创建 一 个 用 户 定 义 的 参数 列表 。 为 每 个 标 
准 类 型 的 入 站 插头 ， 程 序 员 可 以 在 相关 的 事件 处 理 程序 方法 中 创建 一 个 用 户 定义 的 输入 参数 
列表 。 

(2) 挂 起 插头 和 退出 插头 的 参数 

程序 员 可 以 为 这 些 特殊 的 窗 体 插头 定义 参数 。 由 于 这 些 参 数 必须 在 输出 插头 的 URL 中 指 
定 ， 所 以 一 定 是 String 类 型 或 TIHTTPNVP 类 型 : 

退出 插头 和 挂 起 插头 的 所 有 参数 在 目标 URL 中 指定 《退出 插头 是 可 选 的 ， 挂 起 插头 是 强 
WIAD. WR HEr URL 是 Web Dynpro 应 用 程序 ， 则 应 符合 下 列 格式 : 


<schema>://<host>.<domain>.<extension>:<port>/sap/bc/webdynpro/<Namespace>/<application 


name>?<parameter name>=<parameter value> 


退出 插头 和 挂 起 插头 在 运行 时 有 特定 的 字符 串 参 数 URL, 

G) 局 头 插头 和 恢复 插头 的 参数 

局 动 插 头 和 恢复 插头 的 参数 通过 相关 的 事件 处 理 程 序 方 法 调用 的 URL 进行 传递 , 这 意味 
寿 参数 值 来 目 第 二 个 应 用 。 出 于 这 个 原因 , 传递 的 参数 数目 和 名 称 在 设计 时 对 于 主 Web Dynpro 
应 用 程序 来 说 通常 是 未 知 的 。 为 了 能 将 值 传 递 到 入 站 插头 的 URL 参数 中 ,它们 存储 在 一 个 类 
型 为 TIHTTPNVP 的 表 中 。 在 该 表 中 的 所 有 应 用 程序 特定 的 URL 参数 可 以 通过 参数 
WDEVENT 传递 ， 该 参数 属于 局 动 或 恢复 插头 的 事件 处 理 程序 方法 。 在 本 地 创建 的 参数 必须 
是 相同 的 类 型 ， 即 TIHTTPNVP。 
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method HANDLEDEFAULT . 
data: | url parameters type tihttpnvp. 


wdevent-»get data( 


exporting 

name= if wd application-^»all url parameters 
importing 

value =] url parameters ). 


endmethod. 


如 果 在 设计 时 启动 或 恢复 插头 的 参数 是 已 知 的， 程序 员 可 以 将 个 别 参数 字符 串 添加 到 事 
件 处 理 程序 方法 的 参数 中 ， 并 和 直接 访问 它们 。 

如 果 事 件 处 理 程序 方法 的 入 站 插头 有 输入 参数 ， 则 参数 值 必 须 在 运行 时 是 可 用 的 。 如 果 
调用 URL 不 指定 参数 值 , 也 没有 定义 应 用 程序 的 任何 默认 值 ， 则 将 导致 一 个 运行 时 错误 。( 请 
参阅 调用 Web Dynpro 应 用 参数 )。 通 过 定义 默认 值 ， 在 不 指定 参数 值 时 可 以 防止 运行 时 错误 。 

(4) TIHTTPNVP 参数 

表 类 型 TIHTTPNVP 包含 参数 的 名 称 和 值 。 如 果 程 序 员 创建 一 个 这 种 类 型 的 挂 起 插头 或 
退出 插头 的 参数 ， 则 该 参数 是 一 个 表 ， 其 中 包含 字符 串 类 型 的 名 称 和 值 。 在 这 种 情况 下 ， 所 
有 项 都 被 传递 到 URL， 而 不 是 把 每 一 个 参数 分 开 传 递 。 

传递 局 动 插头 或 退出 插头 的 名 称 和 值 都 存储 在 一 个 表 中 。 


注 : 其 URL 参数 的 事件 处 理 程序 方法 也 提供 了 一 个 相关 的 参数 ， 也 以 相同 的 表格 类 型 存 
储 在 参数 表 中 。 处 理应 用 程序 对 类 型 TIHTTPNVP 表 中 传输 参数 进行 检查 和 验证 。 


1.8 ”处 理 Web 图 标 


当 用 户 为 Web 应 用 程序 创建 界面 时 ， 有 具有 固定 大 小 并 能 多 次 使 用 的 图 形 元 素 是 需要 的 。 
例如 使 用 按钮 或 屏幕 列表 中 的 图 标 或 状态 。 这 些 图 标 作为 一 个 对 象 或 一 个 函数 的 图 形 图 像 。 
SAP 为 使 用 最 频 或 的 标准 对 象 和 函数 提供 了 预定 义 的 Web 图 标 。 

Web Dynpro ABAP 提供 了 各 种 技术 来 解决 的 UI 元素 中 的 URL (如 Image.source): 

e 类 CL WD WEB ICON 是 用 于 访问 Web 图 标的 类 。 

e ji Web 图 标 可 以 通过 ~IconAlias 访问 ， 其 中 包含 支持 的 URL 格式 ， 见 表 7-2. 


A 7-2 
格 X 未 dl 
—Icon/Attachment 
—IconAlias —IconLarge/AudioFile 
—Pictogram/2PeopleDocCircularArrow 
$SNAMES$ 是 指 事务 SM59 中 的 一 个 HTTP š 
! ; : NAMES 7 I 
s N 连接 (G 型 ) 条 目 。 如 果 指 定 了 路 径 ， 则 筷 . js $MY HTTP DESTINATIONS/images/ 
y i Dv. 4A trat INI : X , . 


URL 的 唯一 方法 
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格 Ñ 不 à H 
从 服务 器 到 一 个 MIME 信息 库 相 对 路 径 
言 息 入 口 。 这 个 入 口 以 MIME 库 根 目录 开 
m 全。 服务 器 的 URL 总 是 加 载 。 如 果 路 径 是 m ae 
d 一 个 Web Dynpro 的 路 径 ， 则 该 路 径 园 换 为 
一 个 图 标 ， 否 则 没有 方法 确保 该 URL 的 有 
效 性 
I ; s lr 11417.jpg 
MN 从 一 个 活动 组 件 的 MIME 文件 夹 加 载 图 m 
folder/image.ext JT, XAR _ 
images/hello.gif 
UNAMESPACE/ 
COMPONENT j/im 命名 空间 和 
A 图 像 指 定 了 另 一 个 组 件 的 相对 路 径 , 也 可 | 组 件 为 大 写字 (WDR TEST EVENTSYs Ir 11417.jp 
UNAMESPACE | 以 是 一 个 单独 的 组 件 母 ， 路 笃 为 小 | g 


COMPONENT j/fol 写字 三 
der/image.ext 


e 淅 图 标 在 早期 的 版 本 中 的 一 个 子 集 中 ， 并 以 WEBICON * 作 为 头 字 母 ， 见 表 7-3。 


表 7-3 


CU | GU BR. RIT ——1 


VUE GL CLERE SS -IconAT am 
WEBICON «NAME» E. BADEN S-IonAls |— =“: WEBICON CRITICAL 


AP JIT n 
[WWWDATA |/obJectName E. L Lu. sS [WWWDATAJHELLO IMAGE 


注 : 语法 WEBICON * 已 过 时 。 较 早 的 WEBICON * 名 称 内 部 被 映射 到 新 的 Web 图 标 。 
需要 注意 的 是 老 的 SAP GUI 界面 图 标 (ICON *) 不 再 被 使 用 。 


注 : /路 径 ， 不 支持 相对 路 径 ， 就 是 以 下 的 格式 ./path 或 ../path。 


下 列 公共 API 可 用 于 程序 员 开 发 。 

e 值 帮助 : 功能 模块 WDY WB VD ICON PICKER. 

e 数据 元 素 : 网 页 图 标 别名 WDG UR WEB ICON ALIAS. 
e 域名 : 网 页 图 标 别名 WDG UR WEB ICON ALIAS. 
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Has A Web Dynpro For ABAP 系统 类 


SAP 指定 的 用 户 接口 控件 开发 了 许多 Web 应 用 程序 的 UI 元 素 。 这 确保 用 户 将 看 到 一 个 
标准 的 屏幕 ， 然 而 并 非 所 有 的 UI 元 素 显示 在 相同 的 格式 中 ， 这 意味 着 某 些 动态 编程 是 必 
需 的 。 

一 般 规 则 是 , 以 CL_WD 或 正 WD 作为 头 字 母 的 类 和 接口 已 经 为 应 用 程序 开发 人 员 
发 布 。 

ik: 以 CL WDR A IF WDR 开始 的 类 和 接口 尚未 释放 。 这 些 类 不 包含 在 接口 包 中 ， 它 
们 可 以 更 改 ，SAP 不 另行 通知 。 此 外 ， 使 用 这 些 内 部 类 的 方法 调用 有 可 能 会 产生 副作用 。 


以 下 的 编程 接口 文 持 应 用 程序 开发 人 员 进 行动 态 编程 : 运行 时 APIs. Context 节点 APIs, 
个 性 化 APIs、 门 户 集成 APIs. 

1. 运行 时 APIs 

(1) IF WD ACTION 

IF WD ACTION 接口 使 程序 员 能 够 访问 控制 器 的 Action 的 信息 。 

一 个 UI 元 素 可 以 绑 定 到 一 个 动作 Action。 它 是 由 一 个 特定 的 UI 元 素 触 发 事件 发 生 时 执 
行 的 动作 。 如 果 事 件 发 生 时 ， 则 在 相应 的 视图 控制 器 实现 的 事件 处 理 程序 被 调用 。 接 口 属性 
见 表 A-1. 

1) 属性 Attributes: 


X A-1 
属 性 类 H Jo X 
CONTROLLER 实例 属性 动作 Action 的 控制 器 
IS ENABLED 实例 属性 前 Action 是 否 为 活动 的 。 如 果 Action 为 活动 的 ， 则 属性 的 值 为 “X"”， 否 则 
EE 标示 当前 Action 是 否 为 校 验 或 非 校 验 的 Action, WAR Action 为 校 验 的 ， 则 属性 的 
IS VALIDATING 实例 属性 fip X, mp “ ° 
IMAGE 实例 属性 Action 的 Image 图 标 地 址 URL 信息 
PARAMETERS 实例 属性 动作 Action 参数 : 表 或 值 的 名 称 
TEXT KEY 实例 属性 动作 Action 的 标签 文本 
2) TASET 


此 方法 设置 动作 的 属性 。 可 设 定 以 下 可 选 参数 。 

€ ENABLED: 确定 Action 是 否 有 效 或 无 效 。 

@ VALIDATING: 确定 Action 是 进行 验证 或 不 验证 。 
@ IMAGE: 确定 Action 图 标 Image 的 URL 地 址 。 

€ TEXT: 确定 Action 的 文本 标示 。 

(2) IF WD APPLICATION 
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IF WD APPLICATION 接口 可 以 访问 整个 Web Dynpro 应 用 中 有 效 的 数据 。 

方法 : 

1) GET APPLICATION INFO: 返回 应 用 程序 的 元 数据 描述 的 方法 。 结 果 是 一 个 下 WD 
RR_APPLICATION 类 型 的 对 象 。 

2) GET IS RTL: 用 于 取得 该 应 用 程序 的 文本 显示 格式 是 人 否 被 切换 到 从 右 到 左 〈RTL ) 
的 格式 。 


注 : RTL 是 来 自 中 东 的 语言 的 文字 方向 。 例 如 ， 布 伯 来 文 和 阿拉 伯 文 是 从 右 到 左 。 从 右 
到 左 (RTL) 的 反面 是 从 左 到 右 (LITR)， 这 是 正常 的 印 欧 语系 语 顺 。 然 而 ， 在 RTL 语言 中 ， 
数字 ( 如 电话 号 码 或 邮政 编码 ) 和 适当 的 名 称 都 是 从 左 到 右 写 、 因 此 ， 在 RIL 语言 中 往往 是 
LTR 语言 和 部 分 LTR 句子 混合 的 RTL 文本 。 


Web Dynpro 编程 模型 文 持 RTL 概念 。 应 用 程序 开发 人 员 应 注意 以 下 几 点 去 使 用 完整 的 
RTL 设置 : 
QD Minii (Frame) 出 现在 正确 的 顺序 ， 即 相 比 LTR TT] T, RTL 正好 相反 : 
e 末 单 和 内 容 列 表 一 般 设 为 RTL. 
e 实际 的 内 容 一 般 设 为 LTR。 
D 如 果 需 要 ， 则 可 以 创建 图 片 RTL 版 本 ， 并 确保 RTL 版 本 的 图 像 在 应 用 程序 中 使 用 。 
€ GET IS ACCESSIBLE: 用 于 取得 数据 可 访问 的 模式 是 否 被 激活 。 
@ OPEN HELP CENTER: 用 于 打开 帮助 中 心 。 
@ GET REMOTE ADDRESS: 取得 当前 调用 程序 的 IP 地 址 。 
€ GET CLIENT ENVIRONMENT: 返回 应 用 程序 运行 中 客户 问 环 境 。 例 如 ， 客 户 闹 环境 的 
门户 网 站 或 SAP NetWeaver 业务 客户 闹 。 可 以 从 CO CLIENT ENVIRONMENT ë RUE 
得 到 。 
€ GET CONFIGURATION ID: 用 于 取得 正在 运行 的 应 用 程序 的 配置 ID。 
@ GET IS CLOSE WINDOW SUPPORTED: 用 于 返回 关闭 一 个 窗口 是 否 是 可 能 的 。 
(3) IF WD COMPONENT 
IF WD CONTROLLER 接口 使 程序 员 可 以 访问 活动 的 Web Dynpro 组 件 的 信息 。 接 口 被 
类 CL WDR COMPONENT 实例 化 。 该 类 是 所 有 的 Web Dynpro 组 件 的 基 类 。 
在 Web Dynpro 组 件 中 下 面 的 方法 调用 返回 一 个 类 型 为 正 WD COMPONENT 的 组 件 控 
制 器 对 象 : 


data: 
] componentcontroller api type refto if wd component. 


] componentcontroller api = wd this-wd get api( ). 


方法 : 

1) GET ID: 用 来 返回 一 个 唯一 的 组 件 ID. 

2) REMOVE PENDING INPUT: 用 来 清空 尚未 被 传送 到 Context 中 的 用 户 输入 。 

3) GET WINDOW MANAGER: 用 来 得 到 的 窗 体 控制 器 。 结 果 是 一 个 类 型 为 正 WD 
WINDOW MANAGER 的 对 象 。 
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4) GET COMPONENT INFO: 用 来 返回 组 件 的 元 数据 (Metadata〉 摘 述 。 结 果 是 一 个 类 型 
HIF WD RR COMPONENT 的 对 象 。 

5) GET PORTAL MANAGER: 用 来 取得 门户 网 站 管理 器 的 一 个 引用 。 结 末 是 一 个 类 型 
为 下 WD PORTAL INTEGRATION 的 对 象 。 

6) GET CONFIGURATION KEY: 取得 当前 的 配置 客 钥 〈 或 被 设置 为 初始 值 ) 的 方法 。 

7) ADD EVENT HANDLER: 注册 事件 的 事件 处 理 程序 的 方法 。 

8) REMOVE EVENT HANDLER: 注销 事件 的 事件 处 理 程序 的 方法 。 

9) CANCEL NAVIGATION: 禁止 整个 应 用 程序 的 导航 的 方法 。 

100 GET PERSONALIZATION MANAGER: 该 方法 得 到 一 个 个 性 化 管理 器 的 引用 。 结 
果 是 一 个 类 型 为 IF WD PERSONALIZATION 的 对 象 。 

11) GET APPLICATION: 得 到 一 个 应 用 程序 对 象 的 引用 。 结 果 是 一 个 类 型 为 
IF WD APPLICATION 的 对 象 。 

12) GET CMP USAGE GROUP: 得 到 一 个 引用 的 组 件 的 使 用 组 中 。 结 果 是 一 个 类 型 
IF WD COMPONENT USAGE GROUP 对 象 。 

13) CREATE CMP USAGE GROUP: 创建 一 个 组 件 的 使 用 组 。 结 果 是 一 个 类 型 
IF WD COMPONENT USAGE GROUP 的 对 象 。 

14) HAS CMP USAGE GROUP: 确定 组 件 是 否 存在 使 用 组 。 

(4) IF WD COMPONENT USAGE 

IF WD COMPONENT USAGE 接口 使 程序 员 访 问 方法 用 于 操作 (外 部 ) 的 Web Dynpro 
组 件 的 使 用 组 件 。 

为 了 使 用 一 个 不 同 的 Web Dynpro 组 件 ， 必 须 维护 组 件 本 身 的 属性 ， 以 及 想 要 访问 的 组 件 
的 属性 。 下 面 的 方法 调用 后 在 该 控制 器 中 返回 一 个 类 型 为 IF_WD_COMPONENT USAGE 的 
对 象 。 


data: 


component usage type ref to if wd component usage. 


component usage = wd this wd cpuse «Name der Component-Usage^( ). 


方法 : 

1) CREATE COMPONENT: 该 方法 在 组 件 使 用 的 点 上 用 于 创建 Web Dynpro 组 件 。 如 末 
一 个 激活 的 组 件 实例 已 经 存在 用 于 该 组 件 的 使 用 ， 调 用 该 方法 时 会 发 生 运行 时 错误 。 出 于 这 
个 原因 ， 在 调用 该 方法 之 前 使 用 方法 HAS ACTIVE COMPONENT， 以 检查 该 组 件 的 一 个 活 
动 实例 是 否 已 经 存在 。 

2) DELETE COMPONENT: 该 方法 在 组 件 使 用 的 点 上 用 于 删除 Web Dynpro 组 件 。 如 末 
没有 活动 的 组 件 实例 存在 的 情况 下 ， 访 方法 不 能 被 调用 。 

3) HAS ACTIVE COMPONENT: 该 方法 判断 指定 的 Web Dynpro 组 件 是 否 在 该 组 件 使 用 
点 已 经 被 创建 ， 并 且 是 人 否 是 活动 的 。 

4) GET IMPLEMENTING IF VIEW INFO: 该 方法 返回 元 数据 描述 的 接口 视图 。 结 
返回 一 个 类 型 为 IF WD RR INTERFACE VIEW 的 对 象 。 

5) GET INTERFACE CONTROLLER: 该 方法 返回 一 个 Web Dynpro 组 件 的 接口 控制 器 
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的 引用 。 结 果 返 回 类 型 取决 于 Web Dynpro HFA DM fils | R AKHU X, AR n] PLE Ik: 
Tablas Je EPERE. 

6) ADD EVENT HANDLER: 该 方法 可 以 用 于 在 运行 时 注册 动态 事件 的 事件 处 理 程序 。 

7) CREATE COMP USAGE OF SAME TYPE: 该 方法 创建 一 个 指向 同一 个 组 件 的 组 件 
使 用 ， 结 果 是 一 个 类 型 为 IF WD COMPONENT USAGE 的 对 象 。 

8) ENTER. REFERENCING MODE: 可 以 使 用 该 方法 来 确定 一 个 组 件 使 用 指 同 一 个 不 同 
的 组 件 。 

注 : 

QD 组 件 的 使 用 应 该 指向 不 同 的 组 件 (引用 组 件 的 使 用 )， 并 且 该 组 件 不 能 有 任何 活动 的 
组 件 使 用 。 

D 必须 参照 相同 的 组 件 作 为 引用 组 件 的 使 用 。 

9) GET COMPONENT USAGE INFO: 该 方法 返回 元 数据 摘 述 的 组 件 使 用 。 结 果 是 一 
个 类 型 为 下 WD RR COMPONENT USAGE 的 对 象 。 

100 IS REFERENCING: 该 方法 指定 组 件 使 用 是 否 指 问 一 个 不 同 的 组 件 使 用 。 其 结果 可 
能 是 义 〈 组 件 的 使 用 指向 不 同 的 组 件 ) 或 “”( 组 件 的 使 用 不 涉及 不 同 的 组 件 使 用 )。 

11) IS REFERENCED: 该 方法 指定 组 件 使 用 是 人 否 由 不 同 的 组 件 使 用 作为 参照 。 其 结 末 
可 以 是 X (组 件 的 使 用 通过 一 个 不 同 的 组 件 使 用 被 引用 ) 或 “”'( 组 件 使 用 未 引用 不 同 的 组 件 


使 用 )。 

12) LEAVE REFERENCING MODE: 使 该 组 件 的 使 用 不 再 是 指向 另 一 个 不 同 的 组 件 
使 用 。 

13) REMOVE EVENT HANDLER: 可 以 用 于 在 运行 时 动态 注销 一 个 事件 处 理 程序 的 
事件 。 


(5) IF WD COMPONENT USAGE GROUP 

一 个 组 件 使 用 组 将 组 件 的 使 用 组 织 到 一 起 ， 使 用 相同 的 组 件 及 组 件 接口 的 用 法 。 

利用 组 件 使 用 组 使 得 它 更 容易 动态 地 创建 和 管理 组 件 。 

方法 : 

1) GET COMPONENT USAGE: 该 方法 为 组 内 的 一 个 组 件 使 用 的 检索 方法 。 结 果 是 一 
个 类 型 为 下 WD COMPONENT USAGE 的 对 象 。 

2) GET COMPONENT USAGES: 该 方法 用 于 返回 组 内 的 所 有 组 件 使 用 。 

3) ADD COMPONENT USAGE: 该 方法 创建 一 个 组 件 的 使 用 并 添加 组 件 的 使 用 到 
组 内 。 

4) REMOVE COMPONENT USAGE: 该 方法 从 组 中 删除 组 件 的 使 用 。 

5) REMOVE ALL CMP USAGES: 该 方法 从 组 中 删除 所 有 组 件 使 用 。 

6) SET: 该 方法 设置 组 件 使 用 的 属性 。 

(6) IF WD CONTROLLER 

IF WD CONTROLLER 接口 ， 利 用 它 可 以 通过 Web Dynpro 控制 右 能 够 访问 相关 信息 。 

下 和 面 的 方法 调用 返回 一 个 对 象 ， 访 对 象 的 类 型 为 Web Dynpro 组 件 的 组 件 控制 器 内 的 
IF WD CONTROLLER: 
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data: 
lapi type refto if wd controller. 


] api = wd this-^wd get api( ). 


方法 : 

1) GET MESSAGE MANAGER: 该 方法 返回 一 个 消 县 管理 恬 的 引用 。 络 有 末 是 一 个 类 型 
为 下 WD MESSAGE MANAGER 的 对 象 。 

2) GET COMPONENT: 该 方法 返回 一 个 属于 访 控 制 右 的 组 件 引 用 。 结 果 是 一 个 类 型 为 
IF WD COMPONENT 的 对 象 。 

3) GET CONTEXT: 该 方法 返回 一 个 属于 该 控制 器 的 Context 的 引用 。 结 果 是 一 个 类 型 
为 下 WD CONTEXT 的 对 象 。 

4) GET MESSAGE: 该 方法 返回 消息 文本 给 消息 关键 字 。 

5) GET ACTION: 该 方法 返回 一 个 该 控制 左 的 动作 Action 的 引用 。 结 果 是 一 个 类 型 为 
IF WD ACTION 的 对 象 。 

6) GET CONTROLLER INFO: 广 方 法 返回 一 个 该 控制 融 的 元 数据 的 引用 。 络 末 是 一 个 关 
型 为 下 WD RR CONTROLLER 的 对 象 。 

7) IF WD MESSAGE MANAGER: 该 接口 作为 一 个 信息 集成 的 消息 管理 右 ， 为 应 用 程 
序 开发 者 提供 Web Dynpro ARAH H F 

下 面 列 出 比较 重要 的 方法 。 如 果 需 要 了 解 这 些 方法 中 的 各 个 参数 的 描述 ， 请 参见 系统 中 
的 相关 方法 的 文档 。 

Jk: 

需要 注意 的 是 ，RAISE 方法 已 经 过 时 。 出 于 这 个 原因 ， 程 序 员 不 应 该 使 用 它们 。 另 外 ， 
大 多 数 方法 使 用 的 参数 msg_user data 仅 可 用 于 特殊 目的 。 出 于 这 个 原因 ， 程 序 员 不 应 该 使 用 
它 。 相 关 方 法 ， 可 以 使 用 可 选 VIEW 参数 输入 要 在 其 中 显示 的 信息 的 窗 体 或 视图 的 名 称 。 对 
于 REPORT 方法 ENABLE MESSAGE NAVIGATION 参数 信息 ， 可 参见 MessageArea 事件 
(MessageArea Events). 

KE, MHEARAN [RR] REA Ard e PER, — Sq ABE Gris] (这 
ECT BG WEREAEBOSEREPREEEGBIHIO 内 ， 非 一 时 性 消息 是 可 用 的 。 这 使 得 一 个 消息 的 有 效 期 
可 能 为 组 件 的 生命 周期 、 控 制 器 的 生命 周期 、Context 的 生命 周期 (只 适用 于 相关 消息 Context 
的 属性 )。 

IS PERMANENT 和 SCOPE PERMANENT MSG 参数 的 应 用 如 下 。 

1) REPORT EXCEPTION: 报告 一 个 Web Dynpro 异常 《可 以 回 到 原画 面 )。 

2) REPORT SUCCESS: 报告 成 功 的 消息 (m). 

REPORT WARNING: 报告 警告 的 消息 CAD. 

REPORT ATTRIBUTE ERROR MESSAGE: 报告 一 个 Context 属性 相关 的 Web Dynpro 
Ad. ZIAN Context 属性 报告 一 条 铺 误 消 县 。 一 个 Context 相关 的 铺 误 消 县 影响 的 Web 
Dynpro 阶段 模型 的 流量 。 如 果 这 种 类 型 的 错误 信息 在 操作 处 理 程序 之 前 被 调用 《〈 如 在 
WDDOBEFOREACTION 方法 )， 则 标准 〈standard) 类 型 的 动作 不 再 被 执行 。 随 后 的 导航 和 
WDDOMODIFYVIEW 方法 也 不 会 被 执行 。 然 而 ， 独 立 验证 操作 被 执行 时 ， 即 使 存在 错误 的 
消息 ， 后 续 的 导航 及 WDDOMODIFYVIEW 方法 还 是 执行 。 
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REPORT ATTRIBUTE EXCEPTION: 报告 一 个 Context 属性 的 异常 。 该 方法 报告 一 条 
Context 属性 的 Web Dynpro 错误 消息 ， 同 方法 REPORT. ATTRIBUTE ERROR MESSAGE. 

REPORT ERROR MESSAGE: 报告 一 个 市 可 选 参数 的 Web Dynpro IJESTR3H A. C @ )。 
在 这 里 ， 可 以 传输 一 个 字符 串 。 该 学 符 串 可 以 是 一 个 用 户 定 义 的 OTR 文本 或 一 个 寞 第 类 的 文 
本 。 使 用 便 编码 ， 以 确保 它 可 以 很 容易 地 转换 为 文本 。 

IS EMPTY: fri Tt IB. 

REPORT T100 MESSAGE: 报告 一 个 消息 ， 使 用 T100 £ H. 

REPORT FATAL EXCEPTION: 该 方法 报告 一 个 终止 消息 。 这 种 闫 型 的 消 上 县 在 下 面 的 方 
法 中 抛 出 会 导致 Web Dynpro 应 用 程序 因 运 行 时 错误 而 终止 : 

@ WDDOINIT。 

@ WDDOEXIT。 

€ WDDOMODIFYVIEW. 

@ 在 一 个 入 站 事件 处 理 程 序 中 。 

如 果 这 种 类 型 的 消息 生成 在 WDDOBEFORENAVIGATION 或 WDDOPOSTPROCESSING 
方法 或 在 一 个 动作 处 理 程序 中 ， 则 处 理 在 该 点 被 终止 ， 并 显示 一 个 错误 消息 。 

REPORT FATAL ERROR MESSAGE: 报告 一 个 市 有 可 选 参数 的 致命 的 WDA 1545. I] 
能 和 现象 同 REPORT FATAL EXCEPTION. 

CLEAR MESSAGES: 删除 所 有 信息 。 

REPORT ATTRIBUTE T100 MESSAGE: 报告 一 个 Context 属性 的 Web Dynpro YP: o 

REPORT ELEMENT ERROR MESSAGE: 报告 一 个 Context 属性 的 Web Dynpro 例外 。 

这 种 方法 报告 一 条 错误 消息 的 Context 元 素 。 一 个 Context 相关 的 错误 消息 影响 的 
Web Dynpro 阶段 模型 的 流 癌 。 如 有 条 这 种 错误 信息 类 型 CE 型 ) 的 操作 处 理 程序 在 显示 之 
前 被 调用 (如 在 WDDOBEFOREACTION 方法 中 ), 则 标准 类 型 (standard ) 的 行动 (Action ) 
将 不 再 被 执行 ， 随 后 的 导航 和 WDDOMODIFYVIEW 方法 也 不 会 被 执行 。 然 而 ， 独 立 验 
证 操作 会 被 执行 ， 即 使 存在 错误 的 消息 ， 后 续 的 导航 及 WDDOMODIFYVIEW 方法 还 是 
执行 。 

3) REPORT ELEMENT EXCEPTION: 报告 一 个 Context 属性 的 Web Dynpro fll. D 
能 和 现象 同 REPORT ELEMENT ERROR MESSAGE. 

4) REPORT ELEMENT T100 MESSAGE: 报告 一 个 Context 属性 的 Web Dynpro 例外 。 
功能 和 现象 同 REPORT ELEMENT ERROR MESSAGE. 

5) REMOVE MESSAGE: 该 方法 将 删除 指定 ID 的 消息 。 

6) HAS VAL ERRORS FOR WINDOW: 可 以 使 用 该 方法 ， 以 确定 一 个 特定 的 窗 体 中 是 
否 有 Context 引用 的 错误 消 恩 。 

7) HAS VALIDATION ERRORS: 可 以 使 用 该 方法 ， 以 检 答 在 一 个 Context 引用 中 是 否 
有 错误 消息 。 

8) GET MESSAGES: 该 方法 返回 一 个 所 有 可 用 消息 的 列表 。 

9) GET MESSAGE FOR ID: 该 方法 返回 相关 消息 的 信息 。 

(8) IF WD NAVIGATION SERVICES 

该 接口 为 动态 导航 提供 服务 。 
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标 ， 


^^ 


方法 : 

1) PREPARE DYNAMIC NAVIGATION: 此 方法 创建 一 个 指定 参数 的 导航 链接 和 导航 日 
同时 建立 必要 的 视图 般 入 和 视图 容器 分 配 。 如 果 目 标 视图 来 自 一 个 藤 入 式 组 件 ， 如 果 需 
要 ， 则 创建 该 组 件 使 用 。 这 种 方法 被 调用 后 导航 可 以 执行 ， 激活 输 出 插件 中 指定 的 
SOURCE PLUG NAME. 

下 面 是 传 入 参数 : 


SOURCE WINDOW NAME: 用 于 导航 的 窗 体 名 称 , 在 这 个 窗 体 中 苇 入 开始 和 目标 视图 。 
SOURCE VUSAGE NAME: 骨 入 的 开始 视图 名 称 。 

SOURCE PLUG NAME: 出 站 插头 的 名 称 。 

TARGET COMPONENT NAME: 目标 组 件 的 名 称 ， 即 在 内 部 的 窗 体 中 显示 的 视图 。 
TARGET_VIEW_NAME: 进行 导航 的 目标 视图 名 称 。 

TARGET PLUG NAME: 入 站 插头 的 名 称 

TARGET EMBEDDING POSITION: 以 下 列 格式 仍 入 视图 的 位 置 。 


[<View1>/<Container1>.|<View2>/<Container2>] *]. 
如 果 该 参数 锌 设置 为 初始 ， 则 进行 导航 的 视图 将 被 直接 散 入 在 窗 体 中 。 
返回 参数 如 下 : 


COMPONENT USAGE 


组 件 使 用 的 引用 ， 如 果 视 图 来 自 外 部 组 件 则 返回 组 件 使 用 的 引用 。 

2) DO DYNAMIC NAVIGATION: 该 方法 创建 一 个 导航 链接 ， 并 进行 导航 。 

要 做 到 这 一 点 ， 需 为 导航 创建 导航 链接 、 导 航 目 标 、 出 站 插 涉 、 组 件 使 用 、 视 图 舱 入 和 
视图 容器 组 件 〈 这 些 还 不 存在 )， 然 后 进行 导航 。 

下 面 是 传 入 参数 : 


SOURCE WINDOW NAME: 用 于 导航 的 窗 体 名 称 , 在 一 个 窗 体 中 骸 入 开始 和 目标 视图 。 
SOURCE VUSAGE NAME: HATTE BEI AA ES. 

SOURCE PLUG NAME: 出 站 插头 的 名 称 。 

PLUG PARAMETERS: 自 定义 事件 的 参数 列表 。 

TARGET COMPONENT NAME: 目标 组 件 的 名 称 ， 即 在 内 部 的 窗 体 中 显示 的 视图 。 
TARGET VIEW NAME: 进行 导航 的 目标 视图 名 称 。 

TARGET PLUG NAME: 入 站 插头 的 名 称 。 

TARGET EMBEDDING POSITION: 以 下 列 格式 仍 入 视图 的 位 置 。 


[<View1>/ <Container1>.[<View2>/<Container2>]*]. 


如 来 该 参数 被 设置 为 初始 ， 则 进行 导航 的 视图 将 补 直 接骨 入 在 窗 体 中 。 


下 面 是 返回 参数 : 

COMPONENT USAGE: 引用 组 件 使 用 情况 ， 如 果 视 图 来 目 外 部 组 件 ， 则 返回 组 件 使 用 
的 引用 。 

3) REMOVE DYNAMIC META DATA: 该 方法 将 删除 所 有 动态 创建 的 元 数据 (查看 骸 


Z 


A BOLA EAR. FIRER SEHUH bs. HARHAA HESSE KAS 


以 下 的 进口 中 存在 的 参数 : 


SOURCE WINDOW NAME: 用 于 导航 的 窗 体 名 称 , 在 一 个 窗 体 中 航 入 开始 和 目标 视图 。 
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SOURCE VUSAGE NAME: HB TESTIS AR o 
SOURCE PLUG NAME: 出 站 插头 的 名 称 。 
TARGET COMPONENT NAME: 目标 组 件 的 名 称 ， 即 在 内 部 的 窗 体 中 显示 的 视图 。 
TARGET VIEW NAME: 进行 导航 的 目标 视图 名 称 。 
TARGET PLUG NAME: 入 站 插头 的 名 称 。 
TARGET EMBEDDING POSITION: 以 下 列 格式 仍 入 视图 的 位 置 。 
[<View1>/<Container1>. [<View2>/<Container2> ] *]. 
(9) IF WD NAVIGATION SERVICES NEW 
IF WD NAVIGATION SERVICES NEW 接口 使 程序 员 可 以 创建 所 需 的 元 数据 进行 动态 
导航 。 这 使 得 在 设计 时 没有 必要 对 导航 链接 进行 声明 。 不 过 ， 这 应 该 只 用 在 一 个 末 态 声明 的 
叶山 链 接 不 可 能 实现 时 。 在 有 些 迟 况 下 ， 只 有 在 运行 时 才能 确定 视图 或 艇 入 式 组 件 要 显示 。 
接口 IF WD NAVIGATION SERVICES NEW 可 被 Web Dynpro 组 件 中 的 一 个 视图 调用 ， 
如 下 所 示 : 


data: 

] view api type ref to 
if wd view controller, 

] navigation services new type ref to 
if wd navigation services new. 


l view api = wd this-^wd get api( 


). 


] navigation services new ?-] api. 


方法 : 

1) PREPARE DYNAMIC NAVIGATION: 该 方法 创建 一 个 指定 参数 的 导航 链接 和 导航 目 
标 ， 同 时 建立 必要 的 视图 散 入 和 视图 容器 分 配 。 如 果 目 标 视图 来 自 一 个 租 入 式 组 件 ， 如 果 需 
要 ， 则 创建 该 组 件 使 用 。 这 种 方法 被 调用 后 导航 可 以 执行 ， 激活 输 出 插件 中 指定 的 
SOURCE PLUG NAME. 

调用 该 方法 也 导致 对 象 类 型 IF WD REPOSITORY HANDLE 被 创建 ， 返 回 给 调用 者 。 
该 对 象 允 许 访问 元 数据 时 动态 创建 的 方法 被 调用 。 

下 面 是 输入 参数 : 

€ SOURCE WINDOW NAME: 用 于 导航 的 窗 体 名 称 ， 在 一 个 窗 体 中 骨 入 开始 和 目 
标 视 图 。 
SOURCE VUSAGE NAME: 先入 的 初始 视图 的 名 称 。 
SOURCE PLUG NAME: 出 站 插头 的 名 称 。 
TARGET COMPONENT NAME: 目标 组 件 的 名 称 ， 即 在 内 部 的 窗 体 中 显示 的 视图 。 
TARGET VIEW NAME: 进行 导航 的 目标 视图 名 称 。 
TARGET PLUG NAME: 入 站 插头 的 名 称 。 
TARGET EMBEDDING POSITION: 以 下 列 格式 仍 入 视图 的 位 置 。 
[<View1>/<Container1>. [<View2>/<Container2> ] *]. 
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下 面 是 返回 参数 : 
REPOSITORY HANDLE (类 型 IF WD REPOSITORY HANDLE): 在 其 中 所 产生 的 元 数 
据 可 以 被 访 问 的 处 理 。 


2) DO DYNAMIC NAVIGATION: 

动态 进行 导航 。 要 做 到 这 一 点 ， 需 为 导航 创建 导航 链接 、 导 航 目 标 、 出 站 插头 、 组 件 使 
用 、 视 图 戏 入 和 视图 容器 组 件 〈 这 些 还 不 存在 )， 然 后 进行 导航 。 

调用 该 方法 也 导致 对 象 的 类 型 IF WD REPOSITORY HANDLE 被 创建 ， 返 回 给 调用 者 。 
该 对 象 允 许 访 问 元 数据 时 动态 创建 的 方法 被 调用 。 


ik: 使 用 相同 的 出 站 插头 (SOURCE PLUG NAME) 重复 调用 该 方法 。 由 于 在 该 出 站 插 
头 创建 了 多 个 导航 链接 ， 因 此 所 有 这 些 导 航 链接 在 随后 的 导航 阶段 中 ， 可 能 导致 显示 的 不 是 
预期 的 视图 ， 而 是 其 他 的 视图 。 


以 下 的 进口 中 存在 的 参数 : 

e SOURCE WINDOW NAME: 用 于 导航 的 窗 体 名 称 , 在 这 是 一 个 窗 体 中 骨 入 开始 和 日 
标 视 图 。 

SOURCE VUSAGE NAME: HI Em As 

SOURCE PLUG NAME: 出 站 插头 的 名 称 。 

PLUG PARAMETERS: 出 站 插头 的 列表 中 的 参数 值 。 

TARGET COMPONENT NAME: 目标 组 件 的 名 称 ， 即 在 内 部 的 窗 体 中 显示 的 视图 。 
TARGET VIEW NAME: 进行 导航 的 目标 视图 名 称 。 

TARGET PLUG NAME: 入 站 插头 的 名 称 。 

TARGET EMBEDDING POSITION: UJ Ff S NUES Y E, 

| «View 1»/«Containerl^.[«View2-/«Container2»] *]. 

HLK BC ELT URS XETI STUNT ESEÉHIBCELBE BON TE Ed VIS IP e 

下 面 是 返回 参数 : 

REPOSITORY HANDLE (类 型 IF WD REPOSITORY HANDLE): 在 其 中 所 产生 的 元 数 
据 可 以 被 访问 的 处 理 。 

(10) 运行 时 库 APIs 

运行 时 库 由 一 系列 接口 组 成 ， 这 些 接口 可 以 谈 取 一 个 Web Dynpro 应 用 程序 的 元 数据 。 
API 还 允许 动态 元 数据 的 创建 ， 如 在 运行 时 创建 组 件 使 用 或 导航 链接 。 

Web Dynpro 运行 时 库 由 以 下 接口 组 成 : IF WD REPOSITORY HANDLE, IF WD RR ` 
APPLICATION, IF WD RR CMP USAGE GROUP, IF WD RR COMPONENT, IF WD ` 
RR COMPONENT USAGE, IF WD RR CONTROLLER, IF WD RR VIEW, IF WD RR ` 
VIEW CNT ASSIGNMENT, IF WD RR VIEW USAGE, IF WD RR WINDOW, 

(1D IF WD VALIDATION 

接口 IF WD VALIDATION 提供 访问 Context 节点 属性 的 各 种 Web Dynpro 验证 服务 。 

e 斌 取 验 证 信息 。 

e 设置 验证 信息 。 
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方法 : 

1) IS ATTRIBUTE VALID: 检查 属性 是 否 是 有 效 的 。 

2) IS NODE VALID: 检查 东 节 点 的 所 有 元 素 是 否 是 有 效 的 。 

3) IS ELEMENT VALID: 检查 某 元 素 所 有 属性 是 否 是 有 效 的 。 

4) IS CONTEXT VALID: AIRE A Context 的 所 有 六 点 古谷 是 有 效 的 。 

5) SET ATTRIBUTE VALID: 设置 属性 为 有 效 。 

6) SET NODE VALID: 设置 节点 为 有 效 。 

7) SET ELEMENT VALID: 设置 节点 元 素 为 有 效 。 

8) SET CONTEXT VALID: 设置 Context 根 节 点 为 有 效 。 

9) GET MESSAGES FOR CONTEXT: 提取 Context 所 有 的 消息 字符 串 。 

100 GET MESSAGES FOR NODE: 提取 某 Context 节点 所 有 的 消息 字符 串 。 

11) GET MESSAGES FOR ELEMENT: 提取 某 Context 元 素 所 有 的 消息 字符 串 。 

12) GET MESSAGES FOR ATTRIBUTE: 提取 某 Context 属性 所 有 的 消息 字符 串 。 

(12) IF WD VIEW 

接口 正 WD VIEW 是 所 有 的 Web Dynpro 视图 的 通用 接口 。 

方法 : 

1) GET ELEMENT: 该 方法 返回 一 个 视图 UI 元 素 。 访 元素 被 指定 一 个 ID， 或 者 返回 
NULL， 如 果 视 图 UI 元 素 不 存在 。 

2) GET ROOT ELEMENT: 该 方法 返回 相应 的 视图 的 元 素 树 的 根 元 素 。 

3) GET VIEW USAGE: 此 方法 返回 租 入 视图 的 元 数据 的 描述 。 

4) REQUEST FOCUS ON VIEW ELEM: 该 方法 将 焦点 设置 在 一 个 特定 的 视图 元 素 上 面 。 

5) RESET VIEW: 访 方 法 重 置 视图 布局 ， 即 将 单独 的 视图 的 视图 元 素 恢 复 到 在 设计 时 声 
明 的 初始 状态 。 当 筷 被 初始 化 时 所 有 视 岁 的 动态 布局 的 修改 被 恢复 。 

6) SCROLL INTO VIEW: 如 果 参 数 WDLIGHTSPEED 被 激活 时 ,该 方法 放置 一 个 视图 元 
素 到 一 个 浏览 器 的 可 视 区 域 。 


注 : 该 方法 只 能 在 方法 WDDOMODIFYVIEW 内 被 调用 。 


(13) IF WD VIEW CONTROLLER 

IF WD VIEW CONTROLLER 接口 使 程序 员 可 以 使 用 Web Dynpro 视图 控制 器 访问 相关 
信息 。 一 般 由 类 CL WDR VIEW 实施 ， 是 接口 [F_WD_CONTROLLER 的 扩展 。 

方法 : 

1) FIRE PLUG: 该 方法 一 般 用 于 触 友 动 态 生 成 的 出 站 插头 。 

2) GET VIEW INFO: 该 方法 返回 视图 元 数据 对 象 的 一 个 引用 。 

3) REQUEST FOCUS: 该 方法 用 于 Context 中 的 元 素 设 置 焦点 。 

4) REQUEST FOCUS ON ACTION: 该 方法 用 于 设置 焦点 到 Ul 元 素 ， 以 便 触 发 特定 的 
5JTE « 

5) GET CURRENT ACTION: 该 方法 返回 正在 处 理 的 动作 。 

6) GET EMBEDDING WINDOW CTLR: 该 方法 返回 已 嵌入 的 窗口 控制 器 的 引用 。 结 
果 是 一 个 类 型 为 IF WD WINDOW CONTROLLER 的 对 象 。 
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(14) IF WD VIEW ELEMENT 

接口 IF WD VIEW ELEMENT 是 在 视图 中 的 任何 元 素 的 接口 。 该 接口 用 来 唯一 标识 一 
个 元 素 ， 并 提供 相应 的 视图 。 

当 创 建 一 个 元 素 时 ， 分 配 一 个 ID 标识 到 UI 元素 ， 用 于 标示 视图 内 的 元 素 。 

方法 : 

1) GET ID: 返回 元 素 的 唯一 名 称 (ID), 

2) GET VIEW: 返回 UI 元 素 所 在 的 视图 。 

(15) IF WD WINDOW 

O IF WD WINDOW 用 于 一 个 弹出 窗 体 的 打开 、 关 闭 及 编辑 。 

方法 : 

1) CLOSE: 该 方法 寞 步 天 闭 弹 出 “Phase Model Cycle” 下 完成 的 窗 体 。 

2) OPEN: 该 方法 以 措 步 方 式 打 开 弹 出 窗 体 。 

3) SET WINDOW SIZE: 设置 窗 体 的 大 小 。 

4) SET WINDOW TITLE: 设置 窗 体 的 标题 。 

5) SET ON CLOSE ACTION: 该 方法 用 于 当 单 击 “ 取 消 ” 时 注册 用 户 动 作 ,。 

6) SUBSCRIBE TO BUTTON EVENT: 用 于 当 单 击 按钮 时 注册 用 户 动作 。 

7) UNSUBSCRIBE FROM BUTTON EVENT: 用 于 注销 用 户 的 动作 。 

8) SET REMOVE ON CLOSE: 该 方法 用 于 关闭 窗 体 后 删除 窗 体 。 

9) SET BUTTON KIND: 该 方法 用 于 指定 按钮 的 组 合 。 

100 SET MESSAGE TYPE: 该 方法 用 于 设置 消息 类 型 。 

11) SET CLOSE IN ANY CASE: 该 方法 用 于 当 单 击 任何 窗 体 按钮 时 自动 关闭 窗 体 。 

12) SET BUTTON ENABLED: 该 方法 使 按钮 被 激活 和 停 用 。 

语法 : 


data: ] window type ref to If wd window. 


] window-»set button enabled( 


button = «button^ 


is enabled = abap false ). 


源码 中 <button> 代 表 一 个 弹出 按钮 ， 可 以 用 常量 if wd window-»co button 定义 。 

(16) IF WD WINDOW CONTROLLER 

使 用 接口 下 WD WINDOW CONTROLLER 访问 一 个 窗 体 的 属性 。 

方法 : 

1) GET WINDOW: 该 方法 用 于 返回 弹出 窗口 ， 如 果 存 在 。 结 果 是 一 个 类 型 为 
IF WD WINDOW 的 对 象 。 

2) GET WINDOW INFO: 该 方法 用 来 返回 窗 体 的 元 数据 描述 。 

(17) IF WD WINDOW MANAGER 

使 用 接口 下 WD WINDOW MANAGER 可 以 创建 不 同 的 窗 体 和 弹出 对 话 框 。 

方法 : 

1) CREATE EXTERNAL WINDOW: 创建 一 个 外 部 浏览 絮 窗 体 的 方法 。 但 是 ， 如 果 应 
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用 程序 运行 在 门户 网 站 中 ， 则 在 外 部 浏览 器 中 创建 窗 体 是 不 可 能 的 。 该 方法 用 来 创建 一 个 模 
态 的 弹出 窗 体 。 


注 : 模 态 参数 已 经 过 时 了 , 因为 Web Dynpro 中 没有 外 部 模 态 窗 体 , 目前 不 支持 标题 参数 . 


2) CREATE WINDOW FOR CMP USAGE: 该 方法 用 来 使 用 组 件 的 接口 视图 显示 一 个 
弹出 窗 体 。 

3) CREATE POPUP TO CONFIRM: 该 方法 用 于 创建 一 个 弹出 确认 对 话 框 。 

(18) CL WD CUSTOM EVENT 

该 类 可 以 访问 到 动作 或 UI 7628 HJ. Web Dynpro 事件 的 参数 。 动 作 或 事件 的 事件 处 理 程序 
有 一 个 该 类 型 的 输入 参数 。 这 个 类 的 方法 允许 访问 事件 或 动作 的 参数 。 

2. Context 方 点 APIs 

下 面 的 接口 和 ABAP 字典 结构 用 于 Web Dynpro 中 Context 节点 数据 的 存 取 : 
IF WD CONTEXT ~、 IF WD CONTEXT NODE 、 IF WD CONTEXT NODE INFO , 
IF WD CONTEXT ELEMENT, Z#ÉJ WDR CONTEXT ATTRIBUTE INFO. 

如 果 有 一 个 错误 ，Context 处 理 方 法 总 是 会 触发 CX WD CONTEXT, 但 该 寞 党 并 不 
声明 。 

(1) IF WD CONTEXT 

接口 正 WD. CONTEXT 允许 访问 的 一 个 控制 句 的 Context 市 点 的 数据 ， 并 提供 了 用 于 记 
录用 户 输入 的 方法 。 

方法 : 

1) RESET CHANGED BY CLIENT: 该 方法 已 过 时 ， 不 应 该 使 用 它 。 

2) CONTEXT CHANGE LOG. 

(2) IF WD CONTEXT NODE 

BEL] IF WD CONTEXT NODE 使 一 个 单一 的 Context 节点 绑 定 数据 或 从 Context 节点 中 


恋 取 数据 。 
方法 : 
1) BIND ELEMENT: 该 方法 绑 定 Context 元 素 到 Context 节点 上 ， 具 体 参 数 见 表 A-2。 
X A-2 
参数 名 称 类 型 Jo X 
该 参数 可 以 是 一 个 Context 元 素 的 引用 (类 型 为 IF WD CONTEXT 
NEW ITEM 输入 参数 ”| ELEMENTO 或 数据 结构 的 引用 ， 或 数据 结构 本 号 。 如 果 它 是 一 个 数据 结构 ， 


考虑 到 性 能 方面 的 原因 ， 应 该 使 用 BIND_STRUCTURE 


如 果 该 参数 标准 值 ABAP TRUE， 则 该 节点 的 内 容 被 释放 ， 即 该 节点 无 效 ， 
SET INITIAL ELEMENTS aZ i — C VUA 
: : 输入 参数 | ,后 有 新 元 素 插 入 。 否 则 ， 该 元 素 被 添加 到 列表 中 


在 指定 元 素 之 前 添加 新 元 素 (SET INITIAL ELEMENTS = ABAP FALSE 


INDEX 答 入 参数 “| 时 )。 该 值 为 标准 值 0 时 添加 新 元 素 到 最 后 一 个 元 素 
ELEMENT 返回 参数 返回 新 的 元 素 引 用 


调用 方法 时 如 果 有 错误 ， 一 个 异常 类 型 CX_WD_ CONTEXT 被 触发 。 
2) BIND ELEMENTS: 该 方法 绑 定 Context 元 素 到 Context WAE. ZINAA EA 
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iX BIND ELEMENT 是 相同 的 ， 区 别 是 必须 指定 一 个 内 部 表 ， 其 中 可 以 包含 任 一 元 素 引 用 、 
数据 引用 或 数据 结构 。 

3) BIND STRUCTURE: 使 用 该 方法 ， 可 以 根据 一 个 结构 在 节点 中 创建 一 个 狐 的 元 素 。 
该 结构 应 该 与 优选 作为 节点 声明 的 结构 是 相同 的 ， 但 它 不 是 必须 的 。 如 果 访 结构 是 不 一 样 的 ， 
则 对 应 的 移动 Cmove-corresponding) 被 执行 。 在 其 他 方面 ,该 方法 的 行为 与 BIND ELEMENT 
一 样 。 

4) BIND TABLE: 使 用 访 方 法 绑 定 内 部 表 到 Context 节点 。 议 方法 是 BIND ELEMENTS 
的 优化 版 本 。 该 表 包 含 预期 的 数据 。 如 果 该 表 的 数据 结构 与 节点 声明 的 结构 相 匹配 ， 则 下 面 
的 内 部 优化 将 被 执行 : 只 有 表 本 身 传递 到 节点 。 没 有 任何 元 素 实 例 被 创建 。 如 果 访 问 一 个 或 
多 个 元 素 ， 则 这 些 元 素 的 引用 被 创建 。 

Æ ABAP 原则 “Copy-on-write” 用 于 传输 复制 的 表 时 ， 这 意味 者 只 有 当 它 被 改变 时 该 表 
被 复制 ， 而 不 是 在 它 被 传输 时 被 复制 。 


注 : 只 有 索引 表 ， 即 标准 表 和 排序 表 支 持 该 项 操作 。 


5) CLEAR SELECTION: 当前 的 选择 被 清除 。 

6) CREATE ELEMENT: 使 用 访 方 法 创建 元 北 的 引用 ， 以 后 可 以 使 用 BIND ELEMENT J 
法 将 其 人 退 加 到 节点 。 该 元素 的 数据 可 以 在 退 加 到 节点 时 附加 ， 也 可 以 在 以 后 设置 。 创 建 
成 功 后 该 元 素 的 引用 被 返回 。 

7) CREATE ELEMENT STATIC ATTR: 该 方法 已 过 时 ， 因 此 不 使 用 它 。 

8) GET ATTRIBUTE: 该 方法 返回 一 个 Context 属性 的 值 。 

9) GET ATTRIBUTE REF: 该 方法 返回 一 个 静态 或 动态 属性 的 引用 及 属性 值 。 一 个 新 
的 引用 被 创建 。 这 意味 独 所 做 的 内 容 变 更 的 引用 不 改变 属性 本 身 。 

100 GET CHILD NODE: 该 方法 返回 一 个 特定 的 子 节 点 。 

11) GET CHILD NODES: 该 方法 返回 所 有 子 节点 。 

12) GET CONTEXT: 该 方法 返回 引用 控制 右 Context (Context HA). TIE XH 
3$ Context 变化 日 志 的 引用 。 

13) GET ELEMENT: 该 方法 返回 引用 了 一 个 元 素 ， 该 元 素 要 么 是 一 个 特殊 的 索引 的 元 
素 ， 要 么 是 头 选择 的 元 素 。 

14) GET ELEMENTS: 该 方法 返回 一 个 所 有 元 素 引 用 的 内 部 表 。 

15) GET ELEMENT COUNT: 该 方法 返回 元 素 的 数量 。 

16) GET LEAD SELECTION: 该 方法 返回 头 选 择 元 素 的 引用 。 

17) GET LEAD SELECTION INDEX: 该 方法 返回 头 选择 元 素 的 索引 。 

18) GET META PATH: 该 方法 返回 在 元 数据 中 节点 的 路 径 。 该 路径 不 包含 任何 
索引 。 

19) GET NODE INFO: 该 方法 返回 元 数据 对 象 的 引用 CIF WD CONTEXT NODE __ 
INFO), 

200 GET PARENT ELEMENT: 该 方法 返回 某 节 点 的 父 节 点 所 属 的 元 素 的 引用 。 

21) GET PATH: 该 方法 返回 原 控制 右 中 市 点 的 路 人 符 。 该 路径 包 售 市 点 名 称 和 索引 。 

22) GET SELECTED ELEMENTS: 该 方法 返回 所 有 选中 的 元 素 的 列表 。 
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23) GET STATIC ATTRIBUTES: 该 方法 返回 所 有 声明 为 静态 属性 的 副本 。 

24) GET STATIC ATTRIBUTES REF: 该 方法 返回 所 有 静态 属性 的 副本 的 引用 。 

25) GET STATIC ATTRIBUTES TABLE: 该 方法 返回 所 有 的 静态 属性 的 所 有 元 素 。 

26) INVALIDATE: 该 方法 无 初始 化 节点 的 所 有 元 素 。 这 意味 看 ， 所 有 的 元 素 和 子 节 氮 
的 实例 被 删除 。 初 始 化 后 节点 的 状态 是 它 的 初始 状态 。 当 一 个 元 素 或 一 个 属性 被 再 次 访问 ， 
如 果 供 给 方法 是 可 用 的 ， 那 么 供给 方法 会 被 调用 。 

27) IS ALIVE: 该 方法 检查 相关 的 控制 器 是 否 还 在 生命 周期 内 ， 这 意味 看 它 仍 然 可 以 被 
访问 ， 并 没有 被 WDDOEXIT 方法 终止 。 


IS ATTRIBUTE NULL 
IS CHANGED BY CLIENT 


IS FINALIZED 


28) IS SELECTED: 讼 方法 用 于 判断 带 有 索引 相关 联 的 元 素 是 否 科 选择。 


29) IS SUPPLIED: 该 方法 用 于 判断 节点 是 否 填 宛 或 仍 处 于 初始 状态 〈 或 失效 )。 
300 MOVE ELEMENT: 该 方法 设置 头 选择 到 茶 一 个 元 素 。 
31) MOVE FIRST: 该 方法 设置 头 选 择 到 第 一 个 元 素 。 
32) MOVE LAST: 该 方法 设置 头 选择 到 最 后 一 个 元 素 。 
33) MOVE NEXT: 该 方法 设置 了 头 选 择 到 下 一 个 元 素 。 
34) MOVE PREVIOUS: 访 方 法 设置 头 选 择 为 上 一 个 元 素 。 
35) MOVE TO: 该 方法 设置 头 选 择 为 指定 索引 的 元 素 。 
360 PATH GET ATTRIBUTE: 该 方法 返回 数据 的 属性 的 引用 。 该 引用 可 从 ME 市 点 出 
发 通过 相对 路 径 访问 。 如 条 有 一 个 错误 ， 则 会 触发 中 单 类 CX_WD_CONTEXT。 
37) PATH GET ELEMENT: 该 方法 本 质 上 与 PATH GET ATTRIBUTE 相同 ， 但 不 返回 
一 个 元 系 引 用 。 
38) PATH GET NODE: 该 方法 本 质 上 与 PATH GET. ATTRIBUTE 相同 ,但 不 返回 一 个 
节操 的 引用 。 
39) REMOVE ELEMENT: 该 方 法 从 节点 中 删除 一 个 元 素 。 该 元 素 可 以 在 以 后 再 次 奶 加 
到 相同 的 和 点。 
RESET CHANGED BY CLIENT 
SET ATTRIBUTE 
SET ATTRIBUTE NULL 


SET CHANGED BY CLIENT 
SET FINALIZED 


SET LEAD SELECTION 

SET LEAD SELECTION INDEX 
SET SELECTED 

SET STATIC ATTRIBUTES 

SET STATIC ATTRIBUTES NULL 


40) TO XML: 该 方法 对 节点 进行 XML 序列 化 。 
(3) IF WD CONTEXT NODE INFO 


PA. 


IF WD CONTEXT NODE INFO 是 Context 节点 的 元 数据 的 接口 ， 被 用 来 描述 数据 。 
每 个 Context 节点 包含 一 个 有 元 数据 节点 信息 的 引用 。 下 面 是 最 重要 的 元 数据 ,可 以 使 用 
IF WD CONTEXT NODE INFO 访问 : 


e 名 称 (GET NAME). 


单 节点 (IS SINGLETON )。 


多 节点 (IS MULTIPLE), 


强制 性 的 选择 (IS MANDATORY SELECTION). 


o 
o 
e 强制 性 的 节点 (IS MANDATORY). 
o 
o 


多 选 (IS MULTIPLE SELECTION). 
1) GET 方法 : 获取 Context 市 点 和 子 节 点 的 属性 。 使 用 GET 方法 来 返回 单个 组 件 的 Context 


全 ILK A-3. 


I ` 
GET ATTRIBUTE 


GET ATTRIBUTES 


GET ATTRIBUTE NAMES 


GET ATTRIBUTE FORMAT PROPS 


GET CHILD NODE 
GET CHILD NODES 


GET ATTRIBUTE VALUE HELP 
GET ATTRIBUTE VALUEHELP TYPE 


GET CONTROLLER 
GET NAME 


GET PARENT 


GET PRIMARY ATTRIBUTE 


GET STATIC ATTRIBUTES TYPE 


FOLLOW PATH 


R A-3 


Hio X 


获取 一 个 或 全 部 属性 的 信息 

使 用 GET. ATTRIBUTE 方法 可 以 返回 WDR CONTEXT. ATTRIBUTE INFO 属 
性 的 引用 。 使 用 GET ATTRIBUTES 返回 一 个 类 型 为 WDR CONTEXT _ATTR_ 
INFO MAP 的 对 象 ， 这 是 一 个 类 型 为 WDR. CONTEXT ATTR INFO «X 


该 方法 以 STRING TABLE 类 型 的 对 象 返回 所 有 属性 的 名 称 

这 种 方法 要 比 GET ATTRIBUTES 方法 使 用 较 少 的 时 间 和 较 少 的 内 存 , 因为 它 没 
有 提供 太 多 的 信息 。 如 果 只 需要 属性 的 名 称 ， 则 使 用 GET ATTRIBUTE NAMES 
方法 

该 方法 读 取 特 殊 格 式 属性 的 特性 

返回 一 个 或 所 有 子 节 点 

GET CHILD NODE 取得 一 个 子 节点 的 引用 ,GET_ CHILD NODES 取得 一 个 列 
表 ， 其 中 为 所 有 子 节 点 的 名 称 和 引用 


该 方法 得 到 相应 名 称 的 属性 的 输入 帮助 

返回 输入 帮助 的 类 型 

类 型 可 以 是 一 个 ABAP 字典 搜索 帮助 、OVS 输入 帮助 ， 甚 至 一 个 用 户 定义 的 输 
入 帮助 。 该 输入 帮助 也 可 以 是 取消 激活 的 

返回 相关 的 控制 费 的 方法 ， 其 中 市 点 已 被 声明 


返回 Context 节点 的 名 称 


返回 Context 节点 的 父 节 点 。 该 方法 返回 父 节点 的 引用 


基本 属性 是 唯一 重要 的 配置 , 因为 在 运行 过 程 中 不 适用 , 只 在 配置 框架 时 才 支 持 

如 果 节 点 存在 ， 则 该 方法 返回 该 节点 的 基本 属性 的 名 称 

该 方法 从 RTTI 实例 中 检索 静态 声明 的 属性 的 节点 。 返 回 节 点 的 RITI_ Reference 
类 型 。 了 解 RTTI 的 更 多 信息 ， 请 参阅 类 CL. ABAP TYPEDESCR 的 相关 文档 

该 方法 用 于 按照 完整 的 路 径 表 达 式 , 程序 员 可 以 访问 相关 的 目标 节点 。 使 用 这 个 
方法 ,可 以 在 层次 结构 中 从 男 一 个 节点 之 下 的 第 一 个 节点 ( 子 节 点 ) 得 到 相关 节点 
的 引用 


ik: 单个 组 件 返 回 单一 的 名 称 ， 多 个 组 件 则 返回 一 个 列表 ， 
2) HAS/IS 方法 : 被 用 来 返回 Context 节点 的 不 同 的 属性 和 状态 ， 见 表 A-4。 
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A A-4 


J ik 描 x 
HAS ATTRIBUTE VALUE HELP 查询 Context Jt Ej A T5 BJ] x ipe f n] JI 
SANE 检查 相关 的 控制 器 是 否 还 在 生命 周期 内 ， 这 意味 着 它 仍然 可 以 被 访问 ， 并 没有 被 
= WDDOEXIT 方法 终止 
IS CHILD NODE RECURSIVE frif] Context 子 节 点 是 否 是 递归 或 没有 递归 
IS FINALIZED 确认 而 点 信息 和 可 能 的 子 节 点 是 否 能 被 变更 


判断 运行 时 是 否 动态 初始 化 头 选 择 或 始终 设置 为 头 选择 。 这 相当 于 在 开发 环境 中 选 
择 “Initialization Lead Selection” 属 性 


确定 节点 元 素 的 数量 。 在 开发 环境 中 ,Context 节点 属性 使 用 这 两 种 方法 建立 基数 ( 参 
Jl, Context 贡 点 属性 中 的 相关 章节 ) 


IS INITIALIZE LEAD SELECTION 


IS MANDATORY IS MANDATORY 查询 当前 Context 节点 是 否 具 有 人 至少 一 个 节点 元 素 。 如 果 是 真 
IS MULTIPLE (True)， 则 该 节点 具有 基数 1.1 或 1 到 mn， 即 至 少 有 一 个 元 素 被 创建 


IS MULTIPLE 查询 当前 Context 节点 可 以 具有 多 个 节点 的 元 素 。 也 就 是 ， 如 果 基 数 
为 0..n 或 1 到 n， 则 返回 真 〈True) 


确定 视图 中 节点 元 素 被 选择 元 素 的 数目 。 在 开发 环境 中 ， 这 两 种 方法 确定 选择 基数 
IS MANDATORY SELECTION 指定 一 个 节点 元 素 必须 始终 选择 ， 即 该 节点 具有 选 


IS MANDATORY SELECTION 


IS MULTIPLE SELECTION 择 基数 1..1 或 1 到 n | i | | 
IS MULTIPLE SELECTION 指定 可 以 选择 几 个 节点 元 素 ， 即 选择 基数 为 0 .n 或 1 
到 mn 
IS MAPPING COMPLETE 确定 外 部 映射 是 否 被 执行 ， 或 者 组 件 的 映射 是 否 被 调用 者 执行 
确定 Context 节点 被 定义 为 一 个 Singleton 节点 ,一 个 Singleton 节点 只 有 在 运行 时 
IS_SINGLETON 其 父 节 点 被 选中 头 选择 时 才 存 在 。 这 允许 Web Dynpro 运行 时 ，Context 可 以 优化 内 
存 结构 


3) ADD 方法 : 允许 洪 加 子 证 尽 或 厅 反 的 属性 ， 见 表 A-5。 


表 A-5 
J: Q jh jË 
添加 的 动态 属性 。 这 相当 于 用 开发 环境 中 的 Context 3E Greg mE. CER 
结构 字段 NAME (TYPE NAME 或 RTTI) 是 非常 重要 的 


添加 已 有 节点 到 节点 树 。 这 只 能 用 于 曾经 从 树 中 删除 过 节点 ， 否 则 使 用 
ADD CHILD NODE ADD NEW CHILD NODE 
这 相当 于 在 开发 环境 中 用 Context 荣 单 创建 节点 


ADD ATTRIBUTE 


&J£& —^ ex, RRIAT A. EPE AA HP PES ex 4 DS EE — 
的 。 如果 指定 DDIC 结构 的 节点 ， 则 并 不 需要 单独 添加 各 个 属性 — 框架 直接 
生成 属性 

如 果 想 删除 该 节点 ， 则 在 创建 和 点 时 设置 IS_STATIC 为 False 是 很 重要 的 


ADD NEW CHILD NODE 


创建 一 个 节点 映射 到 另 一 个 节点 。 这 里 只 有 名 称 和 映射 路 径 是 相关 的 。 程 序 
员 不 需要 创建 任何 属性 。 属 性 会 从 原来 节点 的 属性 自动 复制 

ADD NEW_MAPPED_CHILD NODE 如 果 指定 的 映射 路 径 ， 它 是 一 个 标准 的 映射 。 如 果 路 径 设置 为 初始 值 ， 需 要 
进行 外 部 可 映射 节点 的 定义 。 要 完成 映射 ， 还 需要 调用 方法 SET MAPPING. 
COMPLETE 


添加 一 个 递归 的 子 节 点 。 这 相当 于 在 开发 环境 中 使 用 Context 菜单 创建 递归 
HR 


4) SET 方法 : 用 来 设置 Context 节点 或 子 节 点 的 属性 ， 见 表 A-6. 


ADD RECURSIVE CHILD NODE 
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KR A-6 


I - 说 HJ 
SET ATTRIBUTE FORMAT PROPS 为 属性 设置 特殊 的 格式 的 特性 
对 于 包含 单位 和 数量 或 货币 数量 和 货币 单位 的 字段 ， 可 以 在 方法 中 写 入 。 同 
SET ATTRIBUTE REFERENCE FIELD 一 个 节点 只 有 一 个 字段 被 接受 。 


如 果 引 用 ABAP 字典 中 所 使 用 的 结构 定义 的 节点 ， 它 用 在 这 里 单独 指定 。 

应 用 程序 可 以 使 用 此 方法 确定 声明 可 引用 货币 和 数量 的 字段 为 该 元 素 的 引用 
和 属性 。 如 果 儿 个 价格 条 目 可 能 为 一 个 货币 ， 这 种 设置 是 重要 的 。 

动态 设置 输入 帮助 ， 即 Context 属性 分 配 的 输入 帮助 可 以 动态 改变 。 可 以 更 


SET ATTRIBUTE REF CALLBACK 


SET ATTRIBUTE VALUE HELP 改 输入 帮助 类 型 (ABAP 字典 搜索 帮助 、OVS 输入 帮助 、 可 编程 输入 帮助 组 件 ) 
以 及 指定 的 输入 帮助 名 称 
SET ATTRIBUTE VALUE SET 设置 允许 值 的 列表 
动态 设置 属性 ， 不 能 在 开发 环境 中 设置 。 节 点 信息 是 不 允许 再 次 被 改变 的 。 
SET FINALIZED 它 是 恒定 的 。 只 要 市 点 已 设置 此 状态 ， 它 就 不 再 改变 ， 一 旦 改变 这 个 节点 ， 一 
个 异常 就 被 触发 
完成 外 部 可 映射 的 节点 的 定义 。 该 方法 被 用 于 外 部 Context 映射 。 使 用 的 组 
SET MAPPING COMPLETE 件 定 义 了 一 个 节点 是 外 部 映射 和 调用 组 件 必 须 指 定 使 用 哪个 节点 。 为 此 ， 它 在 
组 件 使 用 的 接口 控制 器 中 使 用 ， 并 定义 控制 器 和 原始 节点 的 路 径 
SET_NULLABLE 声明 一 个 属性 或 所 有 属性 用 初始 值 和 NULL. 值 的 方式 来 区 分 


5) REMOVE Methods 方法 : 可 将 Context TART T AMEER, Wk A-7。 


E: 不 能 删除 已 被 定义 为 静态 的 属性 。 只 能 删除 在 运行 时 创建 的 属性 。 


A A-7 


MEE JH o x 

动态 属性 可 以 反复 使 用 这 种 方法 ， 将 其 所 有 节点 (运行 时 实例 是 无 效 的 ) 的 
信息 引用 删除 

删除 一 个 子 节点 ， 如 果 它 没有 被 声明 为 非 静 态 节 点 CIL, ADD NEW CHILD - 
NODE)， 则 静态 创建 的 节点 信息 不 会 被 删除 
REMOVE DYNAMIC ATTRIBUTES 删除 动态 声明 的 所 有 属性 。 在 此 节点 上 所 有 节点 的 信息 是 无 效 的 。 


REMOVE ATTRIBUTE 


REMOVE CHILD NODE 


(4) IF WD CONTEXT ELEMENT 

接口 正 WD CONTEXT ELEMENT 通过 一 个 单一 的 Context 元 素 进行 赋值 或 取 值 。 

大 部 分 的 该 接口 的 方法 也 包含 在 IF WD CONTEXT NODE 中 ， 主 要 用 这 些 头 选择 的 元 
素 ， 或 指定 索引 的 元 素 。 

方法 : 

1) GET ATTRIBUTE: 返回 一 个 Context 属性 的 值 的 方法 。 访 方法 的 先决 条 件 是 应 用 程 
序 知道 该 属性 的 数据 类 型 。 给 定 的 属性 的 值 被 复制 到 导出 参数 。 要 做 到 这 一 点 必须 有 导出 参 
数 用 于 值 的 写 入 。 

如 果 属 性 名 称 <attr names: NOT， 则 它 假 设 该 值 是 布尔 值 而 且 相 反 的 值 被 写 入 。 

如 果 属 性 名 称 <attr name>: FINAL， 则 系统 会 检查 是 否 该 属性 值 设 置 为 最 终 并 将 这 些 信 
ESSA. 

如 果 属 性 不 存在 或 值 不 能 被 号 入 ， 则 并 各 类 型 CX_WD_CONTEXT # fi XZ . 


NES 如 果 可 以 返回 几 个 声明 的 元 素 的 属性 值 ， 则 使 用 方法 GET STATIC ATTRIBUTE iñ 
常 是 更 有 效 的 。 
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2) GET ATTRIBUTE REF: 该 方法 类 似 于 GET_ATTRIBUTE， 但 在 以 下 方面 是 不 同 的 : 
e 返回 参数 代 荐 输出 参数 ， 而 且 包 含 属性 值 的 数据 与 引用 。 
e 引用 的 值 不 是 存储 在 内 部 的 引用 。 创 建 相同 类 型 的 数据 ， 该 值 即 被 复制 ， 然 后 该 数据 
作为 参数 类 型 的 引用 输出 。 
3) GET INDEX: 返回 当前 元 素 的 索引 。 
4) GET CHILD NODE: 该 方法 返回 上 共有 指定 名 称 的 子 市 点 。 子 节点 妃 是 由 框架 创建 ， 
而 不 是 应 用 程序 。 


注 : 出 于 性 能 方面 的 考 忘 ， 子 节点 名 称 需 指定 大 写字 母 。 


5) GET CHILD NODES: 该 方法 返回 这 一 种 元 素 的 所 有 子 节 点 作为 一 个 表 ， 其 中 包含 
名 称 和 引用 。 

60 GET NODE: 该 方法 返回 的 元 素 节 点 的 引用 。 如 果 元 素 是 无 效 的 ， 则 一 个 例外 类 
JH CX WD CONTEXT) 会 被 触 友 。 因 此 该 元 到 的 有 效 性 被 确定 。 

7) GET STATIC ATTRIBUTES: 该 方法 返回 所 有 声明 为 静态 属性 的 副本 。 如 果 结 构 是 
不 相同 的 ， 则 操作 move-corresponding 将 被 执行 。 这 是 个 效率 不 高 赋值 ， 但 在 许多 情况 下 ， 仍 
然 是 有 用 的 。 

话 态 属性 是 那些 已 被 声明 为 前 态 或 属于 被 声明 为 静态 市 点 的 结构 。 

8) GET PATH: 该 方法 返回 控制 占 中 原市 点 中 元 素 〈 也 束 是 说 ， 不 是 在 控制 占 中 声明 的 
EIT) 的 路 径 。 可 以 指定 包含 路 径 中 的 控制 问 的 名 称 或 不 指定 〈 见 IF WD CONTEXT _ 
NODE= GET PATH). 

如 果 该 路 径 是 在 搜索 一 个 特定 的 控制 器 《〈 例 如， 如 在 视图 中 绑 定 的 路 径 ) 的 方法 ， 则 方 
法 CL WD CONTEXT SERVICES=> GET ELEMENT PATH FOR CTRL 必须 使 用 ， 由 此 可 
以 提高 系统 的 性 能 。 

9) GET STATIC ATTRIBUTES REF: 使 用 GET STATIC ATTRIBUTES 时 适用 ， 如 末 
是 GET ATTRIBUTE, JHH GET ATTRIBUTE REF. 

100 IS ALIVE: 该 方法 检查 相关 的 控制 器 是 否 还 在 生命 周期 内 ， 这 意味 看 它 仍然 可 以 被 
访问 ， 并 没有 被 WDDOEXIT 方法 终止 。 

11) IS CHANGED BY CLIENT: 指示 Context 元 素 是 否 被 用 户 改 变 。 

12) SET CHANGED BY CLIENT: 一 个 元 素 航 用 户 改 变 〈 见 Context 更 改 日 志 )。 

13) SET ATTRIBUTE: 按照 属性 名 称 设置 属性 值 。 

14) SET STATIC ATTRIBUTES: 如 采 有 多 个 毅 态 声明 的 属性 要 赋值 ， 建 议 使 用 
SET STATIC ATTRIBUTES 方法 。 

15) SET ATTRIBUTE NULL: 设置 属性 为 NULL， 值 为 NULL 的 属性 总 是 显示 为 
这 使 得 可 以 区 分 空 值 和 初始 值 。 

16) SET STATIC ATTRIBUTES: 设置 所 有 评 态 声明 的 属性 。 如 果 不 赋值 ， 则 议 态 属性 将 被 
设 定 为 初始 值 。 如 果 赋 值 即使 两 个 结构 不 完全 符合 ，MOVE-CORRESPONDING 也 将 执行 。 

17) SET _ STATIC ATTRIBUTES NULL: 将 所 有 属性 设置 为 特殊 NULL 值 〈 参 见方 法: 
SET ATTRIBUTE NULL). 

18) SET FINALIZED: 一 个 元 素 设 置 为 最 终 不 允许 用 户 或 应 用 程序 改变 。 最 终 设置 不 能 
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被 撤销 。 但 是 可 以 删除 这 个 元 素 。 
19) SET ATTRIBUTE FINALIZED: 只 有 一 个 属性 被 设置 为 最 终 类 。 


IS FINALIZED 
IS ATTRIBUTE FINALIZED 
200 TO XML: 这 个 元 素 作 为 XML 序列 化 的 属性 。 
21) IS SELECTED: 确定 此 元 素 是 人 否 被 选中 〈 即 这 并 不 意味 看 必须 头 选 择 )。 


22) SET SELECTED: 选择 元 素 。 

3. 个 性 化 APIs 

下 面 的 Web 接口 提供 了 个 性 化 的 Web Dynpro ABAP 应 用 : 

IF WD PERSONALIZATION 接口 包含 Web Dynpro ABAP 组 件 在 运行 时 返回 相关 配置 信 
居 或 更 改 配置 所 使 用 的 方法 的 集合 。 

方法 : 

1) SET CONFIG KEY: 议 置 保存 配置 密 钥 键 的 方法 。 

2) GET STATE: 得 到 当前 加 载 状态 的 信息 。 

3) LOAD CONFIG BY KEY: 用 于 加 载 配 置 或 个 性 化 的 方法 。 

4) GET_VARIANTS: 得 到 一 个 配置 变 式 列 表 的 方法 。 

5) ENTER CHANGE MODE: 切换 改变 模式 的 方法 。 

6) SAVE: 保存 个 性 化 数据 的 方法 。 

7) DELETE: 删除 个 性 化 数据 的 方法 。 

8) GET VALID PERS SCOPE: 获得 最 大 的 保存 范围 的 方法 。 

9) GET DEFAULT VARIANT: 取得 个 性 化 默认 值 的 方法 。 

10) RESTRICT IMPL PERS: 用 于 限制 隐 式 个 性 化 的 方法 。 

11) UPDATE IMPL PERS: 在 动态 改变 UI 元 素 后 更 新 隐 式 的 个 性 化 的 方法 。 

12) GET VARIANTS FOR SUBCOMPONENT: 获取 配置 变 式 列表 的 方法 。 

13) SAVE NEW VARIANT: 个 性 化 数据 的 保存 方法 。 

14) SET DEFAULT VARIANT: 个 性 化 设置 的 默认 值 的 方法 。 

15) TRANSPORT ALLOWED: 用 于 指定 是 否 允 许 数据 传输 的 方法 。 

160 IS IMPLEMENTATION SUPPLIED: 用 于 测试 被 指定 的 一 个 实例 是 否 为 一 个 组 件 使 
用 的 方法 。 

17) SUPPORT DELTA HANDLING: 对 于 每 个 存储 占 动 作 ， 包 括 如 最 终 用 户 在 运行 时 
删除 按钮 这 样 的 操作 ， 系 统 保存 了 隐 含 的 个 性 化 和 明确 的 个 性 化 的 数据 。 但 是 ， 可 以 使 用 
SUPPORT DELTA HANDLING 指定 系统 只 保存 更 改 的 明确 的 数据 ， 而 不 是 配置 控制 名 的 全 
部 内 容 。 

18) GET TABLE READER: 提供 接口 读 取 配 置 数据 表 的 方法 。 

4. 门户 集成 APIS 

在 门户 网 站 中 集成 Web Dynpro ABAP 的 接口 和 类 : 

@ IF WD PORTAL INTEGRATION. 


Z0 


© CL WDR PORTAL OBWEB SERVICE. 

(1) IF WD PORTAL INTEGRATION 

2S IF WD PORTAL INTEGRATION 作为 门户 管理 器 提供 门户 网 站 与 Web Dynpro ABAP 
应 用 程序 集成 的 所 有 必要 的 方法 。 

方法 : 

1) NAVIGATE TO OBJECT: 基于 对 象 的 导航 (OBN) 方法 。 


ik: 参数 USE FORWARDPARAMETERS OF AL 确保 可 以 从 一 个 应 用 程序 传输 到 下 一 个 目 
标的 iView 中 的 JavaScript. 此 ， 不 需要 有 任何 JavaScript 的 目标 IView ( return 
'DynamicParameter---objVal; )， 所 以 参数 从 一 个 应 用 程序 可 以 转发 到 下 一 个 应 用 程序 。 如 果 应 用 
设置 开关 USE FORWARDPARAMETERS OF AL=abap true, 则 应 用 程序 自动 集成 到 门户 网 站 ， 
一 个 额外 的 参数 会 自动 插入 执行 该 操作 。 然 而 ， 这 并 不 与 旧 的 iView 中 JavaScript 相关 联 。 


2) NAVIGATE ABSOLUTE: 绝对 的 导航 方法 。 

3) NAVIGATE RELATIVE: 相对 导航 方法 。 

4) FIRE: 触发 门户 网 站 的 事件 方法 。 

5) SUBSCRIBE EVENT 和 UNSUBSCRIBE EVENT: 注册 和 取消 注册 事件 的 方法 。 

6) SET APPLICATION DIRTY FLAG: 设置 “dirty” 标 志 的 方法 。 

7) SET WORK PROTECT MODE: 设置 工作 保护 模式 的 方法 。 

(2) CL WDR PORTAL OBNWEB SERVICE 

使 用 类 CL WDR PORTAL OBNWEB SERVICE, 在 Web 服务 支持 下 应 用 程序 为 基于 对 
象 导 舱 接收 到 实际 Web 服务 的 封 闻 ， 这 个 类 可 以 更 容易 地 使 用 接口 ， 其 包含 数据 已 经 被 恋 取 
IS) re E ERE e 

方法 : 

1) Constructor: 不 市 参数 ， 这 个 类 可 以 被 实例 化 。 在 这 种 情况 下 ， 标 准 的 Web 服务 端口 
锌 使 用 。 如 果 程 序 员 为 构造 函数 指定 一 个 不 同 的 病 口 ， 则 该 端口 将 个 使 用 。 

2) OBN_GET_DEFAULT_TARGET: 该 方法 返回 的 iView 的 操作 名 称 ， 显 示 名 称 和 操作 
名 称 的 默认 操作 。 设 方法 需要 有 系统 的 别名 和 业务 对 象 的 名 称 。 


注 : 使 用 的 View 的 名 称 ， 也 可 以 触发 在 门户 网 站 中 的 绝对 导航 。 


3) OBN GET DEFAULT TFO: 该 方法 返回 的 1View 的 操作 的 名 称 ， 显 示 名 称 和 操作 名 
称 的 默认 操作 。 该 方法 需要 有 系统 别名 的 名 称 、 业 务 对 象 和 操作 。 

4) OBN GET TARGETS: 该 方法 返回 的 所 有 可 能 的 iView 名 称 ， 显 示 名 称 的 操作 及 有 
关 的 操作 名 称 。 该 方法 需要 有 系统 的 别名 和 业务 对 象 的 名 称 。 使 用 这 种 方法 ， 可 以 生成 所 有 
可 能 的 操作 的 菜单 ， 如 为 LINK TO ACTION 生成 菜单 项 。 

5) OBN GET TFOS: 该 方法 的 工作 原理 同方 法 OBN_GET _ TARGETS。 需 要 操作 的 名 称 。 

6) OBN IS TARGET EXIST: 该 方法 告诉 程序 员 一 个 依赖 于 系统 别名 的 可 能 的 目标 和 
业务 对 象 是 否 存 在 。 

7) OBN IS TARGET EXIST TFO: 该 方法 的 工作 原理 与 OBN IS TARGET EXIST 相 
同 ， 但 需要 男 外 的 操作 名 称 。 
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附录 也 服务 类 (Service Classes ) 


以 下 服务 类 和 接口 提供 Web Dynpro 应 用 开发 的 一 般 服 务 : 


AN 


CL WD ADOBE SERVICES. 

CL WD CONTEXT SERVICES. 

CL WD DYNAMIC TOOL. 

CL WD RUNTIME SERVICES. 

CL WD UTILITIES. 

CL WD TRACE TOOL fll IF WD TRACE TOOL. 
IF WD SELECT OPTIONS. 

CL WD WEB ICON. 

CL WEB DYNPRO. 


. CL WD ADOBE SERVICES 


2$ CL WD ADOBE SERVICES 可 用 于 ABAP 开发 环境 中 , 也 可 用 于 运行 时 的 Adobe 集 


成 环境 中 。 
该 方法 主要 用 于 在 运行 时 创建 PDF 文件 ， 或 解析 运行 时 XML 架构 的 表单 接口 、XML 格 
式 的 表单 数据 。 
(I2 291 
1) CREATE PDF: 该 方法 创建 PDF 文档 , 强制 性 参数 有 ENABLED #I DATA SOURCE. 
重要 输入 参数 : 


© ENABLED: 指定 的 表单 是 个 互动 。 

@ DAIA SOURCE: Web Dynpro Context 的 引用 。 

返回 参数 PDF: 

PDF 文件 作为 XSTRING 输出 。 

2) GET CABVERSION: 为 了 保证 表单 互动 功能 ， 需 要 ActiveX 控制 框架 (ACF)。 该 方 
法 建立 路 径 到 ACEF， 最 终 检查 ACF 是 否 是 最 新 版 本 或 更 高 版 本 是 否 存在 。 

(2) 附加 方法 

其 余 的 方法 都 是 用 来 解析 一 个 XML 架构 或 XML 数据 。 

通过 IXML 解析 器 ， 一 个 XML 文档 《〈 访 架构 以 表单 形式 存在 ) 进行 处 理 ， 一 个 内 部 表 
填 序 数据 。 作 为 架构 表现 为 Web Dynpro 的 Context, 用 于 建立 Context 的 所 有 信息 保存 在 表 中 。 
如 果 该 架构 已 创建 一 个 Web Dynpro 的 Context， 则 名 称 为 FROM WD CONTEXT 的 元 素 
(-True) 可 以 在 第 一 层级 找到 。 在 视图 设计 器 中 ， 程 序 员 可 以 决定 是 否 改 变 Context, XML 
架构 和 XML 数据 通常 以 同样 的 方式 解析 ， 唯 一 不 同 的 是 结果 ， 这 束 是 有 两 种 不 同 的 表 类 
型 的 原因 。 


注 : XML 数据 和 XML 构架 之 间 的 差异 : 构架 描述 的 是 外 部 表单 的 数量 和 字段 的 类 型 ， 
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而 XML 数据 传输 的 实际 数据 包含 在 这 些 字 段 之 中 。 出 于 这 个 原因 架构 是 在 设计 时 , 数据 指 的 
是 在 运行 时 。 

1? GET CONTEXT: 该 方法 返回 描述 Web Dynpro Context 的 内 部 表 。 

2) GET DATA: 该 方法 返回 一 个 内 部 表 ， 它 表示 XML 数据 。 

3) GET FROM WD CONTEXT: 该 方法 搜索 XML 架构 中 所 摘 述 的 FROM WD. 
CONTEXT 标志 ， 并 在 Web Dynpro Context 产生 一 个 架构 的 情况 下 ， 返 回 字 符 X， 人 否则 它 返 
=a i IS 

(3) 解析 方法 

1) PARSE XML SCHEMA: 解析 XML 架构 的 方法 。 

2) PARSE XML DATA: 解析 XML 数据 的 方法 。 

3) PARSE SUBNODE 和 PARSE XML SUBNODE: 解析 深层 骨 套 层次 结构 的 XML x 
档 的 方法 。 通 过 递归 的 方法 调用 。 出 于 这 个 原因 ， 每 个 XML 文档 都 有 自己 的 方法 。 

2. CL WD CONTEXT SERVICES 

CL WD CONTEXT SERVICES 类 用 于 识别 Context 的 变化 。 这 里 指 通过 程序 对 Context 
操作 的 所 有 变化 。 通 党 情况 下 使 用 Context 更 改 日 志 。 

ik: 一 个 * 属 性 名 称 意 味 着 ， 所 有 节点 的 属性 已 经 改变 : 一 个 Context 节点 的 静态 属性 可 
能 被 改变 ， 但 它 不 能 被 指定 为 确定 ， 如 果 设 定 这 样 的 属性 的 值 ， 则 用 户 应 调用 实例 方法 
SET STATIC ATTRIBUTES. 


CL TTA 

1) SUBSCRIBE TO NODE CHANGES: 登记 变更 Context 节点 的 方法 。 

2) UNSUBSCRIBE FROM NODE CHANGES: 注销 变更 Context 节点 的 方法 。 

3) UNSUBSCRIBE ALL: 彻底 注销 变更 的 方法 。 

4) DEACTIVATE SUBSCRIPTIONS: 暂时 停 用 注册 变更 的 方法 。 

5) ACTIVATE SUBSCRIPTIONS: 重新 注册 变更 的 方法 。 

6) GET CHANGE LIST: 取得 之 有 可 选 复位 变更 列表 的 方法 。 

7) RESET CHANGE LIST: 重新 更 改 列表 的 方法 。 

(2) 附加 方法 

下 面 的 方法 提供 了 映射 和 其 原始 节点 的 信息 。 它 们 主要 用 于 视图 中 动态 创建 绑 定 路 径 及 
BASE Eie 

1) GET NODE METAPATH FOR CTRL. 

2) GET MAPPED NODE FOR CONTROLLER. 

3) GET ORIGINAL NODE. 

4) GET ELEMENT PATH FOR CTRL. 


注 : 以 下 的 方法 已 经 过 时 ， 不 应 该 使 用 : UPDATE NODE FROM TABLE BY KEY. 
UPDATE ELEMENT FROM STRUCTURE . UPDATE NODE FROM TABLE BY IND . 
GET TABLE FROM NODE. 
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(3) 操作 

ATE Context 变化 : 

D 生成 的 类 CL WD CONTEXT SERVICES 的 一 个 实例 。 

2) 使 用 SUBSCRIBE TO NODE CHANGES 为 一 组 Context 的 节点 注册 。 

3) 使 用 GET_ CHANGE LIST 定期 取得 更 改 列 表 。 

4) 如 果 有 必要 ， 改 变 开 关 记 录 使 用 ACTIVATE SUBSCRIPTIONS 暂时 关闭 并 重新 
j. 

5) 删除 变化 记录 的 登记 。 

3. CL WD DYNAMIC TOOL 

类 CL WD DYNAMIC TOOL 包含 各 种 方法 ， 这 些 方法 对 动态 编程 的 第 一 个 步骤 Cu 
SE16 复制 ) 是 很 有 用 的 。 

主要 方法 

1) IS STRUCTURE OR TABLE: 方法 SE16 复制 。 

2) GET TABLE DATA: 读 取 数据 的 通用 方法 ， 所 以 没有 任何 checkman 错误 会 发 生 。 

3) CREATE FORM FROM NODE: 从 一 个 下 点 的 属性 创建 表单 的 方法 。 可 以 使 用 该 方 
法 作为 复制 模板 。 

4) CREATE LAYOUT DATA: 根据 父 类 型 创建 一 个 布局 UI 元素 的 实例 的 方法 。 可 以 使 
用 该 方法 ， 在 布局 父 类 型 不 明 的 情况 下 ， 进 行动 态 UI 编程。 

5) CREATE NODEINFO FROM STRUCT: 使 用 预定 义 的 数据 结构 创建 一 个 节点 的 信 
县 对 象 的 方法 。 可 以 使 用 该 方法 进行 SE16 复制 。 


注 : 使 用 IF WD CONTEXT NODE INFO 的 方法 可 以 动态 创建 节点 。 


6) CREATE TABLE FROM NODE: 设 方 法 的 作用 与 CREATE FORM FROM NODE 
相同 ， 这 里 用 于 创建 表格 。 

7) FILL NODE: 该 方法 已 过 时 ， 不 再 使 用 。 

8) SET TREE LEAD SELECTION: 访 方 法 用 于 设置 当前 选 定 的 叶 或 树 中 的 节点 。 
如 果 男 一 个 元 素 已 被 选中 ， 则 该 节点 选中 将 被 取消 。 如 果 没 有 Context 元 素 设 定 ， 则 当 
前 选 定 的 叶 或 节点 被 取消 。 当 一 标 树 UI 元 素 补 使 用 时 ， 在 树 的 Context 初始 化 后 显示 之 
采访 方法 被 调用 一 次 。 如 果 它 不 是 这 种 情况 ， 则 在 同一 时 间 选 择 儿 片 叶子 或 节点 取决 于 
Context 设置 。 

9) CREATE RANGE TABLE: 该 方法 从 指定 的 类 型 动态 地 创建 一 个 郊 围 表 ， 如 可 以 使 
用 选择 选项 (Select Options )。 然 而 ， 应 用 程序 不 仅 限 于 选择 选项 ， 因 为 一 个 标准 的 范围 表 被 
创建 时 ， 使 用 data mytable type range of mytype 语句 创建 mytable。 

4. CL WD RUNTIME SERVICES 

这 个 类 提供 了 一 般 的 Web Dynpro 运行 时 服务 。 

方法 : 

ATTACH FILE TO RESPONSE: 不 使 用 UI 元 素 文 件 下 载 (File Download) 进行 文件 导 
出 方法 。 
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5. CL WD UTILITIES: 2€ CL WD UTILITIES 包含 了 各 种 一 般 功 能 的 方法 。 

方法 : 

1) CALC WIDTHADDLBBYKEY: 使 用 项 目 列表 计算 DropDownByKey UI 元 素 的 宽度 
HE. 

2) SET WIDTH 4DDLBBYKEY: 使 用 项 目 列表 计算 和 设 定 DropDownByKey UI 元 素 的 
宽度 的 方法 。 

3) CONSTRUCT WD URL: 计算 Web Dynpro 应 用 程序 的 URL 的 方法 。 

4) GET OTR TEXT BY ALIAS: 提供 OTR 文本 的 OTR 别名 《系统 调用 包装 器 ) 的 一 
As 

6. CL WD TRACE TOOL 和 IF WD _ TRACE TOOL 

使 用 CL. WD TRACE TOOL 2$, Zj mO IF WD TRACE TOOL, JE WEAS 
属性 INSTANCE， 应 用 程序 开发 人 员 可 以 提供 额外 的 数据 到 Web Dynpro JRE& T. 

要 做 到 这 一 点 ， 需 使 用 接口 F WD TRACE TOOL 包含 方法 ADD TRACE DATA. 

示例 : 


IFCL WD TRACE TOOL=>INSTANCE IS BOUND. 
DATA TRACE DATA TYPE XSTRING. 
" ««« collect your application-specific trace data 


" Add your collected trace data to the trace file for 


" the current roundtrip 
CL WD TRACE TOOL=>INSTANCE->ADD TRACE DATA( 
NAME = 'YourDomain/FileName.Ext' 
XSTRING = TRACE DATA 
). 
ENDIF. 


SAP 建议 添加 一 个 应 用 领域 作为 跟踪 文件 的 前 级 ， 如 SRM/. 

7. IF WD SELECT OPTIONS 

IF WD SELECT OPTIONS 接口 用 于 集成 在 应 用 程序 组 件 的 选择 屏幕 上 的 Selection Options. 
方法 : 

(1) 选择 字段 的 方法 

1) ADD SELECTION FIELD: 选择 屏幕 中 插入 字段 的 主要 方法 。 

2) ADD SELECTION FIELDS: 选择 屏幕 中 添加 多 个 字段 的 方法 。 

3) GET SELECTION FIELD: 返回 选择 屏幕 上 的 字段 的 数据 。 

4) GET SELECTION FIELDS: 返回 选择 屏幕 上 的 所 有 字段 的 数据 。 

5) RESET SELECTION FIELD: 复位 范围 (Range) 表 选 择 字段 。 

6) RESET ALL SELECTION FIELDS: 复位 所 有 范围 表 选 择 字段 。 

7) CHECK ALL SELECTION FIELDS: 检查 所 有 选择 字段 输入 的 正确 性 。 
8) UPD SELECTION FIELD: 更 新 一 个 选择 字段 的 设置 。 
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9) GET RANGE TABLE OF SEL FIELD: 读 取 一 个 范围 表 。 
100 SET RANGE TABLE OF SEL FIELD: 设置 一 个 范围 表 。 
(2) 布局 的 方法 
插入 布局 元 素 的 方法 如 下 : 
€ ADD HORIZONTAL DIVIDER 和 GET HORIZONTAL DIVIDER: 添加 及 返回 选择 
屏幕 中 水 平分 割 的 数据 。 
€ ADD HORIZONTAL DIVIDERS 和 GET HORIZONTAL DIVIDERS: 添加 及 返回 选 
择 画 面 中 多 个 水 平分 割 的 数据 。 
€ ADD TEXT LINE 和 GET TEXT LINE: 添加 及 返回 选择 屏幕 中 文本 行 中 的 数据 (如 
字符 串 )。 所 有 允许 的 设计 是 一 个 TextView TR- 
€ ADD TEXT LINES 和 GET TEXT LINES: 新 增 及 返回 选择 画面 中 的 多 行文 本 Cr 
fj] FO. 
(3) Ek (Blocks) 的 方法 
与 块 相 关 的 方法 如 下 : ADD BLOCK. ADD BLOCKS, GET BLOCK, GET BLOCKS. 
程序 员 可 以 使 用 的 用 户 界面 元 素 有 组 〈Group)、 托 盘 (Tray) 或 透明 容器 (Transparent 
Container ) 。 
(4) 参数 的 方法 
这 些 方法 对 应 于 上 述 指定 的 选择 字段 的 方法 ,区 别 在 于 参数 的 差异 :ADD PARAMETER _ 
FIELD, ADD PARAMETER FIELDS, GET PARAMETER FIELD, GET PARAMETER FIELDS, 
SET VALUE OF PARAMETER FIELD, GET VALUE OF PARAMETER FIELD, RESET ` 
PARAMETER FIELD, RESET ALL PARAMETER FIELDS, CHECK ALL PARAMETER ` 
FIELDS. 
C5) 标准 结构 的 方法 
标准 结构 的 方法 有 GET SELECTION SCREEN ITEM、GET SELECTION SCREEN 
ITEMS、ADD SELECTION SCREEN ITEM、ADD SELECTION SCREEN ITEMS、REMOVE 
SELECTION SCREEN ITEM. 
从 选择 画面 中 移 除 一 个 元 素 。 
这 里 唯一 的 参数 是 要 删除 的 字段 的 ID A ID). 
@ REMOVE ALL SEL SCREEN ITEMS 
从 选择 屏幕 中 移 除 所 有 元 素 。 如 果 有 一 个 块 ， 则 连同 其 内 容 将 整个 块 从 显示 屏幕 中 移 除 。 
(6) 帮助 方法 
1) CREATE RANGE TABLE: 创建 一 个 动态 范围 表 。 
2) SET GLOBAL OPTIONS: 指定 按钮 是 可 见 的 。 
8. CL WD WEB ICON 
这 个 类 的 静态 方法 提供 有 关 Web Icon 的 信息 。 
方法 : 
1) GET COLLECTIONS: 该 方法 返回 Web Icon RE 
2) GET WEB ICONS: Z j |u|— 4 ruk Bi 44 S243 Web Icon. 
3) GET WEB ICON URL: 该 方法 返回 Web Dynpro 应 用 程序 相关 的 URL (一 个 Web 
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Icon 的 网 址 )。 

9. CL WEB DYNPRO 

Web Dynpro 环境 的 应 用 程序 是 否 使 用 ABAP 字典 搜索 玫 助 在 运行 租 询 ， 可 以 通过 关 
CL WEB DYNRPO 的 属性 的 is active 进行 判断 。 

句法 : 


IF CL WEB DYNPRO=>1s active = abap true. 


ELSE. 


ENDIF. 
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